用途:指导创建可用于生产的 MCP 服务器,遵循官方 SDK 模式与安全实践。适用从零构建服务器、为已有服务器添加工具/资源/提示词、在 TypeScript 与 Python 之间选择实现方式、为 MCP 工具加入错误处理与校验、配置结构化日志。不适用于审查已有 MCP 代码、无需 LLM 集成的简单 CLI 工具、HTTP REST API(MCP 使用 JSON-RPC),以及非 MCP 的通用开发。
技术选择:TypeScript 类型安全好,配合 Zod/Ajv 做模式校验,适合复杂 schema 的生产服务器;Python FastMCP 基于装饰器,原型速度快,适合快速验证或与 Python 库集成。
主要流程:1)初始化服务器,TypeScript 用 @modelcontextprotocol/sdk 的 Server 与 StdioServerTransport,Python 用 FastMCP;2)定义工具及 inputSchema,每个属性都需描述;3)实现处理器并在处理前校验输入,TypeScript 可用 Ajv;4)可选添加资源,如 config://settings;5)可选添加提示词模板;6)实现结构化日志,务必输出到 stderr,stdout 保留给 JSON-RPC;7)启动服务,TypeScript 连接 StdioServerTransport,Python 调 mcp.run(transport="stdio")。
关键限制与注意:错误响应需带 isError: true 并给出可操作建议;正则处理前限制输入长度以防范 ReDoS;不要硬编码密钥,改用环境变量;日志误写 stdout 会导致服务挂起或输出乱码。相关技能包括 mcp-server-reviewing、security-scan、quality-check。安装命令与价格信息暂未提供。