1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mcp-builder | — |
| 作者/维护者 | Anthropic（anthropics/skills 官方仓库） |
GitHub API |
| 来源链接 | https://github.com/anthropics/skills/tree/main/skills/mcp-builder | — |
| 许可证 | Apache License 2.0（子目录内含独立 LICENSE.txt） | GitHub 仓库文件 |
| GitHub Stars / Forks | 所属合集仓库 160,669★ / 18,963 forks（合集仓库 stars 不计给单个 skill，见第 6 章说明） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新；本子目录最近一次改动为 2026-04-20（许可证补全） | GitHub API（commits） |
| 安装方式 | npx degit anthropics/skills/mcp-builder skills/mcp-builder 或整仓库 clone 后复制子目录 |
仓库文档 |
2. 功能介绍与亮点
mcp-builder 教开发者构建高质量的 MCP（Model Context Protocol）Server，让大模型能通过设计良好的工具访问外部服务。核心是四阶段工作流：
- 调研与规划：研究 MCP 协议规范与目标 API，权衡“全面覆盖接口”与“面向工作流的精简工具集”
- 实现：搭建项目结构、API 客户端、错误处理、输入输出 schema，提供 TypeScript 与 Python 双语言参考实现
- 评审与测试：代码质量与类型检查，用官方 MCP Inspector 实测
- 评测集构建：撰写 10 道独立只读测试题，验证 Agent 仅凭该 MCP Server 能否完成真实任务，而非停留在“能跑通”
亮点：Anthropic 官方出品，与 MCP 协议规范同步；强调工具描述、错误信息对 Agent 友好（含 readOnlyHint / destructiveHint / idempotentHint 等注解元数据）；首创把“评测”作为交付物之一，而非仅给模板代码。
3. 适用场景
固定分类：集成与工作流自动化
- 需要把内部系统、SaaS 服务接入 Claude Code / Codex 等 Agent 的开发者
- 已有 API、想快速包装成 Agent 可用工具集的团队
- 希望遵循官方最佳实践、避免“能跑但 Agent 用不好”的中级开发者
- 需要系统评测自建 MCP Server 质量的团队
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方为 Claude 生态设计并维护
- Codex：未验证——未见 Codex 专属适配说明
- OpenClaw：未验证——抓取材料中未提及
- Hermes Agent：未验证——抓取材料中未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
MCP 已成为 Agent 连接外部世界的事实标准协议，但“写一个能跑的 MCP Server”和“写一个 Agent 真正用得顺手的 MCP Server”差距很大——工具粒度不合理、错误信息不友好、缺乏评测手段，都会让 Agent 频繁用错工具。mcp-builder 把 Anthropic 内部沉淀的设计经验系统化为四阶段流程，并把“用 10 道任务题验证 Agent 能否仅靠该 Server 完成真实工作”作为交付标准，而不是靠人工审查代码“看起来对不对”。对中级开发者而言，这是从“能跑通”迈向“Agent 好用”的官方地图。
6. 评分
| 维度 | 分数 |
|---|---|
| 受欢迎程度 | 9 |
| 可用性 | 9 |
| 安全性 | 8 |
| 综合评分 | 8.7 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 仅用于开发/测试阶段（跑生成的 Server、跑 MCP Inspector），无破坏性操作 |
| ② 运行时联网外发 | 仅访问 modelcontextprotocol.io 官方协议文档与 GitHub SDK 文档，不上传用户数据 |
| ③ API key/凭据 | skill 自身不要求任何凭据；目标服务的 key 由用户后续自行配置，不属于本 skill 范畴 |
| ④ 可疑指令 | 抓取的 SKILL.md 全文未见 prompt injection 或隐藏指令迹象 |
| ⑤ 作者信誉 | Anthropic 官方仓库，信誉最高档 |
| ⑥ License | 子目录内含独立 Apache License 2.0 全文，权责清晰 |
| ⑦ 维护时间 | 所属仓库整体活跃（最近推送 2026-07-01）；本子目录内容自 2025-12 起结构稳定，判定为“完整非弃置” |
安全性未给满分的原因：受“合集仓库 stars 不得计给单个 skill”规则限制，子目录级别的一手社区讨论证据（issue/PR 热度）较薄弱，二手证据主要来自第三方技术文章介绍而非一手讨论，故落在 7–8 档而非 9–10 档。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | Stars | 目标场景 | 是否需第三方凭据 |
|---|---|---|---|---|
| mcp-builder（本次推荐） | 官方元技能：教你构建 MCP Server | 所属仓库 160k+（子目录不单独计） | 通用，任意目标服务 | 否（构建阶段本身不需要） |
| claude-code-notion-plugin | 官方现成插件（Notion 出品） | 439 | 直连 Notion | 是，Notion API Token |
| claude-supermemory | 社区现成插件，Agent 跨会话记忆层 | 2,687 | 持续记忆/知识积累 | 是，需 Supermemory 云端账号 |
| linear-claude-skill | 社区现成技能，管理 Linear Issue | 117 | 直连 Linear | 是，Linear API Key |
差异化：其余三者都是“已经造好的轮子”——开箱即用但只服务单一第三方（Notion / Supermemory 云 / Linear），且都需要目标服务的凭据并产生数据外发。mcp-builder 是“教你造轮子”的通用方法论，不绑定任何单一服务商，价值在于当团队要接入的服务没有现成 skill 时，提供官方认可的设计规范与评测标准，而非替代这些现成插件。
8. 用户评价
本次决选阶段的抓取聚焦主文档 SKILL.md 本身，未另行发起用户评价专项抓取；搜索摘要中虽有多篇第三方技术文章介绍该 skill，但均为工具说明性质，未见可直接引用的具名评价原文。如实说明：本次未收集到足够的具名用户评价，不编造、不凑数。
9. 其他补充
提供 TypeScript 与 Python 两套参考实现；内置的 10 题只读评测框架可复用于任何自建 MCP Server 项目，不局限于用本 skill 直接生成的代码。
10. 安装使用方式
- 方式一（推荐）：
npx degit anthropics/skills/mcp-builder skills/mcp-builder，放入项目技能目录后 Claude Code 自动识别 - 方式二：
git clone https://github.com/anthropics/skills.git，复制skills/mcp-builder子目录到自己项目 - 安装后无需重启；Claude Code 在涉及“构建 MCP Server”相关任务时会自动触发该 skill（需按标准技能目录结构放置）
- 无需额外 API Key 即可开始使用；仅当被引导构建的目标 MCP Server 需连接具体第三方服务时，才需要该服务自身的凭据
11. 注意事项
- 该 skill 教的是“如何构建”，本身不提供任何现成的第三方服务连接；若诉求是“马上连上 Notion/Linear”等具体服务，应直接选用对应的官方或社区现成 skill，而非从零自建
- 与 Codex / OpenClaw / Hermes Agent 的兼容性未经验证，非 Claude 生态使用前需自行确认技能加载机制是否兼容
- 子目录级别的一手社区讨论证据有限，建议结合官方文档与自身试用综合判断