此乃 TypeScript 之架构,用于生产 MCP 服务器,内置可插拔之认证,每工具之速率限制,结构化之审计日志,及 OpenTelemetry,使汝可构建实用之工具,而非重造枯燥之部分.
吾所读之每篇 MCP 服务器教程,皆示汝注册一工具,使回响字符串。继而挥别“生产之虑”,终篇.
生产之虑 者,此帖
@hailbytes/mcp-server-template乃吾所持之 TypeScript 框架,用以构建企业可实际运行之 MCP 服务器。其备有:
- 认证——可插拔之中介,用于 API 密钥、OAuth 及 JWT;
- 速率限制——按客户端与按工具分别限制,使一失控代理不能倾覆全服务器;
- 审计日志。 — 工具调用及会话事件之结构化日志
- OpenTelemetry — 迹线与指标,使汝得实察模型所为
- 多传输 — SSE、stdio及HTTP,于架构时择之
构架新服务器
npx @hailbytes/create-mcp-server my-server --transport=sse
汝得一处所,可cd入而npm run dev即刻。
或编程嵌入之
import { createMcpServer, defineTools } from "@hailbytes/mcp-server-template";
const tools = defineTools([
{
name: "echo",
description: "Echoes the input back.",
inputSchema: { type: "object", properties: { message: { type: "string" } } },
handler: async ({ message }) => ({ content: [{ type: "text", text: message }] }),
},
]);
const server = await createMcpServer({
name: "my-server",
version: "1.0.0",
transport: "sse",
tools,
auth: { type: "api-key", header: "X-Api-Key" },
rateLimit: { requestsPerMinute: 60 },
audit: { destination: "stdout" },
});
await server.start();
此乃"生产MCP服务器"之全部差异,较之教程回声示例。
与之配之@hailbytes/mcp-security-scanner,则可得一服务器,其默认即安全,且添设之器亦恒保其安。
npx @hailbytes/create-mcp-server my-server
源:github.com/hailbytes/mcp-server-template — 依MIT许可。











