mcp-builder

用途：mcp-builder 是一份用于创建高质量 MCP（Model Context Protocol）服务器的开发指南，目标是让 LLM 通过设计良好的工具与外部服务交互。n 主要流程分为四阶段。第一阶段研究与规划：理解现代 MCP 设计，平衡 API 覆盖与工作流工具，采用一致前缀与动作导向的清晰命名，注重上下文管理与可执行的错误信息；查阅 MCP 协议文档（从 https://modelcontextprotocol.io/sitemap.xml 开始，具体页面加 .md 后缀获取 Markdown 格式）；研究框架文档，推荐 TypeScript（SDK 支持好、静态类型、便于 AI 生成）、远程服务器用 Streamable HTTP（无状态 JSON）或本地用 stdio；规划 API 与工具选择。n 第二阶段实现：建立项目结构，实现核心基础设施（带认证的 API 客户端、错误处理、响应格式化、分页支持）；每个工具需定义输入模式（TypeScript 用 Zod，Python 用 Pydantic）、输出模式、工具描述，采用 async/await、可执行错误信息，并支持 readOnlyHint 等注解。n 第三阶段审查与测试：检查代码质量与类型覆盖；TypeScript 运行 npm run build，再用 npx @modelcontextprotocol/inspector 测试；Python 用 python -m py_compile your_server.py 验证语法并用 MCP Inspector 测试。n 第四阶段评估：创建 10 个独立、只读、复杂、真实、可验证且稳定的评估问题，输出为 XML 格式（含 question 与 answer）。n 适用场景：需要为 LLM 构建连接外部服务的 MCP 服务器的开发者。限制：资料未提供该技能自身的收费、价格或具体平台要求。