mcp-builder – MCP Server 开发 Skill

Skill 详细介绍

anthropics/skills#mcp-builder 是什么

mcp-builder 是 Anthropic 官方 skills 仓库中的一个 Skill，作用是指导 AI Agent 一步一步构建符合 MCP（Model Context Protocol）规范的 MCP Server。MCP 是 Anthropic 提出的开放协议，用来让大模型应用以统一方式连接外部工具、数据源和服务。mcp-builder 把这个过程变成了一套可执行的工作流：从确定 Server 的用途、设计工具（tools）与资源（resources）、选择传输方式（stdio / HTTP）、编写服务端代码，到本地运行、调试和接入 MCP 客户端。

它本身不是一个可以独立运行的软件，也不是一个现成的 MCP Server。它更接近于一套面向 Agent 的开发指南和指令集：安装后，Agent 在处理“如何写一个 MCP Server”“帮我把某个 API 封装成 MCP”“为我的工具设计 MCP 接口”这类任务时，会调用这个 Skill 的方法论和技术要求，而不是凭模型自由发挥。

核心用途

• 根据用户需求设计 MCP Server 的能力边界：暴露哪些 tools、resources、prompts。
• 按 MCP 规范生成 Server 端代码，通常使用官方 SDK（TypeScript / Python 等语言）。
• 设计 JSON Schema 形式的工具入参和返回值，保证工具描述清晰、可被模型正确调用。
• 搭建本地调试环境，把 Server 接进 MCP 客户端进行验证。
• 处理常见工程问题：错误返回、超时、鉴权、传输方式选择、日志。

它不是什么

• 不是 MCP 官方 SDK，SDK 由 Model Context Protocol 官方维护。
• 不是运行时代理，不负责托管你的 Server。
• 不自动把你的业务系统变成 MCP，需要 Agent 按它给的路线实际写代码。
• 不提供图形界面。

典型任务

1. “把我的内部 REST API 封装成一个 MCP Server。”
2. “帮我用 TypeScript 写一个查询 PostgreSQL 的 MCP Server。”
3. “设计一个 MCP Server，让模型能读取我本地某个目录的文件。”
4. “我的 MCP Server 接进客户端后工具列表不显示，帮我排查。”
5. “这个 MCP tool 的 inputSchema 该怎么写更清晰？”

谁适合用

• 需要为内部系统、工具或数据源搭建 MCP 接入的开发者。
• 在做 AI Agent、想让 Agent 调用自有工具链的团队。
• 已经了解基本后端开发，想系统按 MCP 规范落地的人。

谁不太适合

• 只想“一句提示词自动生成能上线的 MCP Server”，并且完全不看代码的人。
• 想找一个即装即用的现成 MCP 连接器，而不是自己构建 Server 的场景。
• 没有任何编程环境、也不打算安装运行时的人。

与普通 Agent 能力的区别

不装这个 Skill 时，Agent 也能凭通用知识写 MCP Server，但容易在协议细节、工具命名、schema 设计、传输方式、错误处理上不一致。装上之后，Agent 有统一的参考路线，产物更贴近当前 MCP 规范和最佳实践。

Skill 安全评估

总体判断

mcp-builder 来自 Anthropic 官方 skills 仓库，来源清晰。它本身是一套开发指导型 Skill，不是常驻后台的服务，也不是会自动联网、上传数据的程序。它的风险主要来自“它引导 Agent 生成并运行 MCP Server 代码”这一过程，而不是 Skill 文件本身。也就是说，风险取决于你和 Agent 在构建 MCP Server 时实际执行了什么。

主要风险点

1. 生成并运行代码。构建 MCP Server 通常需要写代码、安装依赖、运行服务。如果 Agent 拥有 Shell 执行权限，它会自动跑安装、启动、测试命令。这一步是你真正需要关注的：代码来源是否可信、依赖是否来自官方包、服务是否监听公网。
2. 依赖供应链。MCP Server 会引入 SDK 和第三方包（如 Node、Python 生态）。风险与普通后端项目一致：需要留意包名是否官方、版本是否可信。
3. 权限范围。如果你要构建的 MCP Server 用来读取文件、访问数据库或调用内部 API，那么被生成出来的 Server 会持有相应凭证和能力。权限设计应由你决定，不要默认放开。
4. 网络暴露。如果选择 HTTP 传输方式，默认绑定地址和端口需要看清，避免无意中把内部工具暴露到公网。
5. 凭证处理。生成的 Server 可能通过环境变量读取 API Key、Token。凭证不要硬编码进代码，也不要随手提交进 Git。

风险控制建议

• 如果只需要让 mcp-builder 帮你草拟代码，可以关闭 Agent 的自动执行 Shell 权限，改为手动执行安装和启动命令。
• 对生成出来的代码先本地通读一遍，再连接真实数据和凭证。
• MCP Server 用到文件读取、数据库、内部 API 时，遵循最小权限：只开放必要的目录、表、接口。
• HTTP 传输方式上线前确认监听地址，避免 0.0.0.0 直接对外。
• API Key、Token 通过环境变量或密钥管理注入，不写进源码。
• 把你构建出来的 MCP Server 当作普通后端服务对待，纳入常规代码审查和依赖管理。

没有“100% 安全”的结论。合理使用、按最小权限接入、人工复核产物，风险是可控的。

Skill 使用要求

一、Agent / 客户端

mcp-builder 属于 Anthropic 官方 skills，首要适配目标是与 Skills 机制配合最紧密的 Claude 环境，尤其是 Claude Code。在 Claude Code 中使用时，Agent 可以直接读取 Skill 内容并按其中的方法论组织代码。

官方没有公布完整的第三方 Agent 兼容列表。不过从 Agent Skill 的工作方式看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 通常也可以尝试使用；不同 Agent 的 Skill 加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

Skill 本身只是指南内容，不需要额外运行时。是否需要下列环境，取决于你实际要构建的 MCP Server 用什么语言和 SDK：

官方资料没有给出这些运行时的强制版本号，不要凭猜测填写；请以对应语言生态和 MCP 官方 SDK 的当前说明为准。

三、权限

• 文件读取：需要，用于读取项目和 Skill 内容。
• 文件写入：需要，用于生成 MCP Server 代码。
• Shell 执行：可选但常见。Agent 会用它安装依赖、运行、调试。若不想自动执行，可关闭，由你手动运行。
• 网络：构建时通常需要，用于拉包和查文档。
• 数据库 / 内部 API 凭证：不是 Skill 本身要求，而是你构建的 MCP Server 目标系统可能需要。

四、账号 / API Key

mcp-builder 本身不需要账号、API Key 或 Token。它不访问外部服务。你在它指导下构建的 MCP Server，是否要账号、API Key、Token，取决于该 Server 连接的目标系统，例如某个内部 API、第三方平台或数据库。

最小使用条件

1. 一个支持 Skill 加载的 Agent（优先 Claude Code）。
2. 要构建的 MCP Server 所用语言运行时（Node.js 或 Python，按需）。
3. 可写入代码的目录。
4. 可选：关闭自动执行权限，改由人工运行命令。

Skill 安装、使用与卸载教程

一、安装

直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行即可。

如果不知道自己的 Agent 该怎么装，可以直接问当前 Agent：

如何安装 anthropics/skills#mcp-builder？

也可以指定环境：

如何在 Claude Code 中安装 anthropics/skills#mcp-builder？
如何在 Codex 中安装 anthropics/skills#mcp-builder？
如何在 Cursor 中安装 anthropics/skills#mcp-builder？

让 Agent 按其 Skill 加载 / 管理机制指导你完成。不同 Agent 的安装位置和加载方式可能不同，交给对应的 Agent 处理通常最稳妥。mcp-builder 目前没有需要额外说明的特殊安装前提。

二、安装后如何使用

安装后无需特殊命令触发。当你向 Agent 提出“构建 MCP Server”这类任务时，Agent 会依据 mcp-builder 的指引推进。关键在于把需求和约束说清楚：目标工具、采用的语言、传输方式、是否涉及凭证、数据范围。

自然语言使用示例：

使用 mcp-builder，帮我为公司内部的用户查询 API 设计一个 MCP Server，用 TypeScript，走 stdio 传输。

使用 mcp-builder，把本地 /data/reports 目录封装为一个 MCP Server，让我可以通过工具读取其中的报告文件。

使用 mcp-builder，帮我检查现有 MCP Server 的工具定义，看看 inputSchema 有没有设计问题。

如果任务较复杂，建议先让 Agent 只输出设计（工具列表、schema、传输方式），确认后再写代码。

三、卸载

卸载方式取决于你使用的 Agent / Skill 管理器。常见做法是：

1. 使用对应 Agent 的 Skill 管理界面删除 mcp-builder；
2. 或直接询问当前 Agent：“如何卸载 anthropics/skills#mcp-builder？”

不同 Agent 的 Skill 安装位置和管理方式可能不同，如果没有统一卸载命令，让当前 Agent 帮你移除通常更省事。mcp-builder 不会在你的系统里常驻后台进程，卸载一般就是移除对应的 Skill 内容。

常见问题

1. 安装后 Agent 没有识别到 mcp-builder，怎么办？

先确认该 Agent 是否支持 Skills 或自定义指令加载。支持的话，检查安装位置是否符合该 Agent 要求的目录或机制。最简单的办法是直接问 Agent：“你能否使用 anthropics/skills#mcp-builder？如果不能，告诉我还缺什么。”

2. mcp-builder 会直接生成一个可用的 MCP Server 吗？

它会指导 Agent 按 MCP 规范生成代码，但产物需要你运行、调试和接入，才能真正可用。它不是一个点击即部署的生成器。

3. 我不用 Claude Code，在 Codex / Cursor / Trae 里能装吗？

官方没有公布完整第三方 Agent 兼容列表。在支持 Skills 或类似加载机制的 Agent 中通常可以尝试。兼容程度和加载方式以对应 Agent 当前版本为准。

4. 用 mcp-builder 构建的 MCP Server 会改动我现有的项目吗？

Skill 本身不会主动改动项目。是否修改、在哪修改，取决于 Agent 生成代码时你给的目录和指示。建议在独立目录或分支中开发，确认后再合并。

5. 中国大陆使用有额外网络要求吗？

mcp-builder 本身不访问外部服务，使用它没有中国大陆专属的网络前提。但构建 MCP Server 时如果拉取 npm / pip 依赖，可能会受到镜像源和网络环境影响，按常规方式配置镜像即可。

6. 我必须给 Agent 开 Shell 权限吗？

不是必须。你可以只让 Agent 产出代码和命令，由你手动执行安装、启动和测试。这样便于逐条复核，适合对安全较敏感的场景。

7. 它和直接用 MCP 官方文档自己写有什么区别？

自己看文档自由度更高，但需要自己拿捏协议细节。mcp-builder 把流程和工程习惯打包给 Agent，让产物更一致，适合让 Agent 快速起草和规范校验；具体协议细节仍应以 MCP 官方文档为准。