MCP 服务器构建器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/cn-mcp-builder
技能介绍
解决什么问题
MCP 服务器容易做成简单接口包装:工具描述含糊、错误信息不可操作、输出缺少结构化约束,导致 LLM 难以稳定调用外部服务。mcp-builder 把这些开发约束变成流程化指南,帮助工程师把外部 API 变成可被模型理解和组合的工具。
如何工作
它按四个阶段组织开发:
- 调研与规划:先读取 MCP 规范、传输机制、工具/资源定义,并比较 API 覆盖与工作流工具。
- 实现:优先推荐
TypeScript+ 可流式 HTTP,也支持Python+stdio;用Zod/Pydantic定义输入,尽量提供outputSchema,并添加readOnlyHint、idempotentHint等注解。 - 审查与测试:检查 DRY、错误处理、类型覆盖,使用构建检查和 MCP inspector。
- 评估:生成 10 个独立、只读、可验证的真实问题,测试 LLM 能否完成复杂任务。
适用边界
它更像开发规范和工作流,不直接替代 SDK、框架或后端服务。若目标服务没有稳定 API、认证复杂或需要写操作,应优先补充业务封装和权限控制,再按指南接入 MCP。
使用场景
- 为 GitHub API 设计工具命名与分页,让智能体稳定查询仓库和问题。
- 按 TypeScript SDK 定义 Zod 输入和 outputSchema,把天气服务包装成 MCP 工具。
- 用 MCP inspector 测试错误信息与只读注解,审查本地服务器调用行为。
- 创建 10 个独立只读评估问题,验证 LLM 能否完成多步 API 查询。
适合人员
- 要为 GitHub API 建 MCP 服务并控制工具行为的后端工程师
- 需要把天气服务包装成 MCP 工具的全栈工程师
- 需要审查本地 MCP 服务器错误信息的应用工程师
- 要验证 LLM 多步查询 MCP 工具的算法工程师