MCP 服务器总被 LLM 嫌弃?试试这个官方 Skill

为什么你的 MCP 服务器总被 LLM 「嫌弃」?

做 MCP 服务器接入的时候,你是不是也遇到这种糟心事——代码写得挺漂亮,LLM 却不买账,调了半天工具调用就是不对?

问题往往不在代码本身,而是接口设计思路跑偏了。Anthropic 官方出的 mcp-builder 就是来解决这个问题的。

它是什么?

mcp-builder 是 Anthropic 官方 Skill 仓库里的一个技能模板,专门指导你从零构建生产级的 MCP 服务器。它不只是一个代码生成器,而是一套结构化的四阶段工作流

  • Research:研究 MCP 设计原则,搞清楚 API 覆盖策略 vs 工作流工具的区别
  • Implement:脚手架项目,搭建 API 客户端,处理错误、分页、认证
  • Review:代码质量检查,类型覆盖、描述清晰度
  • Evaluate:用 10 个独立只读问题做评估,验证 LLM 是否真的能用你的服务器

核心亮点

最实用的几个设计:

  • 工具注解(Tool Hints):给每个工具打标签——readOnlyHintdestructiveHintidempotentHint,LLM 看见就知道该不该调用、要不要用户确认。
  • 输入输出 Schema 规范:有明确的命名规范、响应格式化要求,减少 LLM 的猜测成本。
  • 评估框架:内置 10 个验证问题,用结构化方式测试你的服务器是否真的「LLM-friendly」。

数字说话

这个 Skill 在 skills.sh 上累计安装 60,300+ 次,周均 28,400 次,GitHub 仓库本身 104.6K stars——妥妥的官方顶流。

适合谁?

  • 想把自家 API 快速封装成 MCP 服务器的开发者
  • 已经在做 MCP 但接入效果不理想的团队
  • 想系统学习 MCP 协议设计规范的工程师

怎么安装

一行命令搞定:

npx skills add https://github.com/anthropics/skills --skill mcp-builder

支持 Claude Code、Cursor、Windsurf、Codex 等所有主流 Agent 工具。

说实话,做 MCP 服务器这件事,理解设计原则比写代码更重要。mcp-builder 把这套原则拆解成可操作的步骤,值得认真过一遍。

GitHub 仓库地址 →


GitHub: https://github.com/anthropics/skills/tree/main/skills/mcp-builder

评论区

0 条评论

登录后可评论。

江望 11 阅读