想给 Claude 接外部 API？Anthropic 官方这份 mcp-builder Skill 我直接抄作业

做了大半年 Claude 应用，最近让我眼前一亮的，是 Anthropic 自己仓库里这份 mcp-builder Skill。

它是干嘛的？一句话：教 Claude 怎么从零给你写一个 MCP Server，让你的 Agent 能连上 GitHub、Slack、Notion 这些外部服务。

以前我自己写 MCP server，基本就是对着 modelcontextprotocol.io 的文档硬啃，工具命名瞎起，错误提示也糊弄。用上 mcp-builder 之后，等于让 Anthropic 的工程师手把手帮你做 code review。

这份 Skill 真正牛的 4 个点

1. 工具命名规范：用 github_create_issue 这种 service_action 形式，前缀统一，Agent 找工具不再迷路。
2. 覆盖度 vs 工作流：教你怎么平衡”把 API 全暴露”和”封装工作流工具”，很多 MCP server 一上来就堆 50 个工具，Agent 直接懵圈。
3. 上下文管理：工具描述要简洁，支持分页过滤，不要一次吐 1000 行回来把 context 撑爆。
4. 错误信息要 actionable：报错要告诉 Agent 下一步该干嘛，不是甩一句 error 500。

推荐技术栈

• 语言：TypeScript（SDK 质量高、静态类型、AI 生成代码也准）
• 传输：远程用 Streamable HTTP（无状态 JSON，好扩），本地用 stdio
• 规范文档：直接抓 modelcontextprotocol.io/sitemap.xml 拿到最新版本

实测了一下午，写了个接 GitHub Issues 的 MCP server，Claude 调用起来丝滑很多。最关键是它强迫你思考”工具对 Agent 友不友好”，而不只是”我能跑通”——这两件事差得远。

📦 项目地址（必看）：https://github.com/anthropics/skills/tree/main/skills/mcp-builder

如果你的 Agent 还在靠 prompt 硬连外部服务，建议直接 clone 这份 Skill，丢给 Claude，让它给你量身定制 MCP server。比看文档快 10 倍。

#Claude #MCP #AgentSkill #开发工具