mcp-builder · MCP 服务器构建指南
创建高质量 MCP（Model Context Protocol）服务器的构建 skill：把外部 API/服务包装成设计良好的工具，供 LLM 调用。
四阶段流程：调研与规划（协议规范、工具设计原则）→ 实现（TypeScript 或 Python 双路线）→ 评审与测试（MCP Inspector 联调）→ 评估验证（10 道真实场景评估题）。推荐技术栈：TypeScript + 远程用可流式 HTTP、本地用 stdio。
调用示例：在聊天框中说"帮我为公司的工单 API 构建一个 MCP 服务器"。
产品详解
定位
mcp-builder 是从零构建 MCP 服务器的端到端指南：质量标准是"LLM 能否用它完成真实任务"。覆盖协议研究、工具设计、实现、测试与评估，产出可发布的 MCP server 工程。
核心能力
- 调研与规划：研读 MCP 协议规范（sitemap → .md 页面）与框架文档；权衡"全量 API 覆盖"与"工作流工具"两种设计取向。
- 工具设计规范：清晰的工具命名（统一前缀 + 动作动词）、Zod/Pydantic 输入 schema、outputSchema 结构化输出、可操作的错误信息、readOnlyHint 等注解。
- 实现：TypeScript（推荐）或 Python（FastMCP）双路线；异步 I/O、分页支持、错误处理 helpers。
- 评审与测试：代码质量检查（DRY、类型覆盖、错误处理一致性）；MCP Inspector 联调（
npx @modelcontextprotocol/inspector）。 - 评估验证：按评估指南编写 10 道独立、只读、复杂、可验证的评估问题，并亲自求解验证答案。
工作流程
- 调研与规划：读协议规范与框架文档，列出要实现的接口
- 实现：搭项目骨架 → 写基础设施（认证、错误处理、分页）→ 逐个实现工具
- 评审与测试：代码走查，Inspector 联调
- 创建评估：10 道评估题，XML 格式输出
输入与输出
| 输入 | 说明 |
|---|---|
| 目标服务的 API 文档 | 必填，接口说明、认证方式、数据模型 |
| 语言偏好 | 选填，TypeScript（推荐）或 Python |
输出：MCP server 工程（含工具实现）、评估 XML 文件。
与相邻 skill 的区别
- claude-api：用 Claude API 构建 LLM 应用的参考手册（消费 LLM 能力）。
- mcp-builder（本）：为 LLM 构建外部工具（MCP server）的指南（生产工具）。MCP server 是 claude-api 应用可接入的工具来源之一。
适用场景
- 把公司内部 API 包装成 LLM 可调用的工具
- 为特定数据源构建标准化的 LLM 接入层
- 发布 MCP server 前的质量评估与打磨
使用前准备
- 无需 API key；需要目标服务的 API 文档与认证方式说明。
- 建议熟悉 TypeScript 或 Python；评估题需人工确认答案可验证、随时间稳定。
mcp-builder 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。