SuperAPI AI 工具集

mcp-builder

编程与开发

查看项目

更新于 10-16 08:09

技能介绍

用途:教会开发者搭建高质量的 MCP 服务器,让大语言模型经由设计良好的工具调用外部服务。适用于为 Claude Code 创建外部 API 集成、构建 AI 辅助工作流的自定义工具、扩展 Claude 的领域专用能力、自动化第三方服务交互,以及构建可团队共享的 MCP 服务器。

主要能力与流程:文档给出四阶段开发流程。阶段一深度调研与规划,需权衡 API 覆盖与工作流工具、研读 MCP 协议、分析目标 API 端点,并明确用户动作、可用端点、只读与破坏性操作区分、错误处理方式。阶段二实现,提供 TypeScript 项目初始化命令:mkdir my-mcp-server && cd my-mcp-server、npm init -y、npm install @modelcontextprotocol/sdk zod、npm install -D typescript @types/node,并给出 tsconfig.json 配置、基于 Server 与 StdioServerTransport 的最小服务器结构、ListToolsRequestSchema 与 CallToolRequestSchema 处理器写法。阶段三评审与测试,要求无重复代码、完整类型覆盖、正确处理错误与输入校验,按需限流,并用 npx @modelcontextprotocol/inspector node dist/index.js 测试。阶段四创建评估,生成 10 个独立、只读、可验证的真实测试问题。

使用方式与建议:语言推荐 TypeScript,因其 SDK 支持好、兼容性与强类型佳。传输方式上远程服务器用 Streamable HTTP,本地服务器用 stdio。工具命名用一致的动作前缀,如 github_create_issue、slack_list_channels。错误信息要可操作并给出下一步。破坏性工具需加注解,如 destructiveHint、readOnlyHint、confirmationHint。高级模式包括分页拉取、用 Bottleneck 限流、从环境变量读取密钥。集成 Claude Code 需写入 claude_desktop_config.json 或项目根的 .mcp.json;权限可用 mcp__my-server__* 通配符;可用 export MCP_TIMEOUT=60000 调整启动超时,claude --mcp-debug 调试。文档还给出安全实践、错误对照表与执行清单,并列有响应时间、错误率、类型覆盖、测试覆盖等指标目标。限制方面,具体收费、价格与完整平台支持暂未提供。