用途
mcp-builder 是一份指导创建高质量 MCP（Model Context Protocol）服务器的技能。MCP 服务器提供工具，使 LLM 能够访问外部服务和 API。服务器质量以「LLM 能否借助所提供工具完成真实世界任务」来衡量。
主要能力
该技能围绕四个阶段组织开发流程：
阶段一：深度研究与规划
- 理解以智能体为中心的设计原则：为工作流而非仅 API 端点构建工具；合并相关操作（例如同时检查可用性并创建事件的 schedule_event）；优化有限的上下文窗口，返回高信号信息而非数据堆砌，提供「简洁」与「详细」两种响应格式，默认使用人类可读标识符而非技术代码；设计可操作的错误信息，引导智能体正确使用；遵循自然任务划分，用一致前缀分组相关工具；采用评估驱动开发。
- 研读 MCP 协议文档（https://modelcontextprotocol.io/llms-full.txt）。
- 研读框架文档：Python SDK（https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md）或 TypeScript SDK（https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md）。
- 详尽研究目标服务的 API 文档，包括认证授权、速率限制与分页、错误响应与状态码、端点与参数、数据模型与模式。
- 制定实现计划：工具选择、共享工具与辅助函数、输入/输出设计（Pydantic 或 Zod 校验模型、一致响应格式、字符限制与截断策略如 25,000 tokens）、错误处理策略。
阶段二：实现
- 搭建项目结构：Python 使用 MCP Python SDK 与 Pydantic 模型；Node/TypeScript 使用 MCP TypeScript SDK 与 Zod 模式。
- 先实现核心基础设施：API 请求辅助函数、错误处理工具、响应格式化函数（JSON 与 Markdown）、分页辅助、认证/令牌管理。
- 系统化实现工具：定义输入模式（含约束与示例）、编写完整文档字符串/描述、实现工具逻辑（异步 I/O、多响应格式、分页、字符限制）、添加工具注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。
- 遵循语言特定最佳实践：Python 使用 Pydantic v2、类型提示、async/await、模块级常量；TypeScript 使用 server.registerTool、Zod .strict()、严格模式、无 any 类型、显式 Promise 返回类型、配置构建流程。
阶段三：审查与优化
- 代码质量审查：DRY 原则、可组合性、一致性、错误处理、类型安全、文档。
- 测试与构建：MCP 服务器是长时间运行的进程，直接在主进程中运行会挂起。安全测试方式包括使用评估工具、在 tmux 中运行、或使用超时（timeout 5s python server.py）。Python 可用 python -m py_compile 验证语法；Node/TypeScript 运行 npm run build 并确认生成 dist/index.js。
- 使用质量检查清单。
阶段四：创建评估
- 创建 10 个评估问题，测试 LLM 能否有效使用服务器回答真实、复杂的问题。
- 每个问题须独立、只读、复杂、真实、可验证、稳定。
- 输出为 XML 格式，包含 question 与 answer 的 qa_pair。
使用方式
该技能以文档与参考文件形式提供，开发过程中按需加载：核心 MCP 文档、MCP 最佳实践、Python/TypeScript SDK 文档、语言特定实现指南、评估指南。
适用场景
需要为 LLM 构建与外部服务或 API 交互的 MCP 服务器的开发者，尤其是希望工具设计符合智能体使用习惯、上下文高效、错误可操作的场景。
限制
资料未提供该技能的具体安装命令、收费信息、支持的平台范围或实际效果数据。