build-mcp-server – MCP Server 开发 Skill

Skill 详细介绍

anthropics/claude-plugins-official#build-mcp-server 是 Anthropic 官方 Claude 插件仓库（claude-plugins-official）中的一个技能（Skill），名为 build-mcp-server。它的作用是引导和辅助 AI Agent 完成 MCP Server（Model Context Protocol 服务器）的构建工作。

它本质上是什么

它不是一个可以直接运行的程序，也不是一个独立的软件包。它属于 Skill 这一类形态——本质上是一套面向 AI Agent 的指令、方法论和工作流集合。安装之后，Agent 会获得一套结构化的指导，用于在构建 MCP Server 时提供方向、步骤和代码组织建议。

它不是什么

– 不是 MCP Server 运行时本身，不会替你部署或托管一个服务器
– 不是 MCP SDK，不替代官方 MCP SDK 的安装
– 不是跨平台独立工具，主要面向 Claude Code / Claude 生态

核心用途

MCP（Model Context Protocol）是 Anthropic 提出的开放协议，让 AI Agent 能够通过标准接口调用外部工具、数据源和服务。构建一个 MCP Server 涉及若干固定环节：确定传输方式（如 stdio、HTTP）、定义工具 / 资源 / 提示（tools / resources / prompts）、设计 JSON Schema、编写请求处理逻辑、测试与调试。

build-mcp-server 的作用，是在这些环节中给 Agent 提供系统化的指导，把「我要做一个 MCP Server」这样的模糊需求，拆解成可执行的搭建步骤。

典型任务

– 从零设计一个 MCP Server 的结构
– 确定该用哪些工具（tools）、资源（resources）和提示（prompts）
– 编写工具的输入 / 输出 Schema
– 选择并搭建传输层（stdio、HTTP 等）
– 编写请求处理逻辑
– 调试和验证 MCP Server 与客户端的联通

工作方式

用户向 Agent 描述要构建的 MCP Server 目标（例如「为我的内部 API 做一个 MCP Server，暴露查询订单和创建工单两个工具」），Agent 加载该 Skill 后，按照 Skill 内置的流程逐步推进：先澄清需求，再设计接口，再生成代码骨架与实现，最后辅助测试。Skill 本身提供的是方法与结构，实际生成的代码仍由 Agent 依据上下文产出。

适合哪些用户

– 想要为自己的服务、内部 API 或数据源构建 MCP Server 的开发者
– 想在 Claude Code 中快速搭建 MCP Server 原型的用户
– 已经理解 MCP 基本概念、希望有结构化搭建流程的人

不适合哪些需求

– 只想要一个现成 MCP Server、不打算自己构建的用户
– 与 MCP 无关的普通编程任务
– 需要开箱即用的托管服务或 SaaS 的场景

如果用户尚未了解 MCP 协议本身，建议先阅读 MCP 官方文档，再使用该 Skill，会顺利得多。

Skill 安全评估

总体判断

build-mcp-server 来自 Anthropic 官方插件仓库，来源可信度较高。它的本质是指导性 Skill，主要产出是文本指导、代码骨架和实现建议，本身不携带独立的运行时或后台服务。安全性主要取决于两个层面：Agent 在执行它建议的命令时的权限，以及所构建的 MCP Server 本身的实现质量。

来源可信度

– 来源：Anthropic 官方插件仓库 anthropics/claude-plugins-official
– 这类官方来源的 Skill 通常经过一定程度的维护和审查，明显优于来源不明的第三方同名 Skill
– 使用前请确认安装来源确实是该官方仓库，而非 fork、镜像或第三方重新发布版本

可能的权限行为

Skill 在辅助构建 MCP Server 时，Agent 可能会：

– 读取项目文件（查看现有代码结构、依赖）
– 写入文件（生成新的服务器代码、配置文件）
– 执行 Shell 命令（安装依赖、运行测试、启动服务器验证）
– 访问网络（拉取依赖、查询文档）

这些行为都属于构建 MCP Server 的正常工作范围，本身不等于风险。风险点在于 Agent 的权限范围：如果开启了自动执行 Shell，Agent 可能在你未逐条确认的情况下安装依赖或运行命令。

降低风险的做法

– 如果只需要该 Skill 帮你生成代码和设计，可以关闭 Agent 的自动执行 Shell 权限，所有安装、启动、测试命令由你手动执行
– 在独立目录或新分支中构建 MCP Server，避免 Agent 直接改动现有项目
– 使用前确认安装来源是官方仓库
– 构建出的 MCP Server 在接入生产环境前，自行做代码审查和权限检查（尤其是它能访问哪些数据、暴露哪些工具）

关于所构建的 MCP Server 本身

Skill 不会替你决定 MCP Server 的安全边界。你构建出来的 Server 是否安全，取决于它的实现：它暴露了哪些工具、能读写哪些数据、是否校验输入、是否有认证机制。这部分需要你或你的团队自行把控。

Skill 使用要求

一、Agent / 客户端

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

二、运行环境 / 依赖

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先，其他支持 Skill 的 Agent 可尝试 |
| 网络 | 首次安装 Skill 时需要访问仓库；构建 MCP Server 时按需访问依赖源 |
| MCP SDK / 语言运行时 | 取决于你构建的 MCP Server 使用哪种语言与官方 SDK，常见为 TypeScript / Node.js 或 Python |

Skill 本身是指导性指令集，不强制绑定某一语言。你构建的 MCP Server 用什么语言实现，就准备对应的运行时和官方 MCP SDK。官方未明确固定版本要求，请以 MCP 官方 SDK 与对应语言的最新说明为准。

三、权限

– 文件读取：经常需要（查看项目结构）
– 文件写入：经常需要（生成 Server 代码与配置）——可选，可让 Agent 只给出代码由你手动落盘
– Shell：常见（安装依赖、运行测试）——可选，可关闭自动执行，改为人工执行
– 网络：按需（拉取依赖）

四、账号 / API Key

该 Skill 本身不需要额外的账号、API Key 或 Token。

但你构建的 MCP Server，如果它连接的是需要鉴权的第三方服务（如某个内部 API、数据库、SaaS），那么这些服务的 API Key、Token 或 OAuth 凭证由你的 Server 侧配置，与 Skill 本身无关。请把这些凭证放在环境变量或专门的密钥管理方式中，不要硬编码进代码。

最小使用条件

1. 一个支持 Skill 的 Agent（推荐 Claude Code）
2. 一个用于构建 MCP Server 的项目目录
3. 明确你想要的 MCP Server 目标（要暴露什么能力）
4. 构建时按需安装对应的 MCP SDK 与语言运行时

Skill 安装、使用与卸载教程

一、安装

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

如果不确定自己的 Agent 如何安装 Skill，可以直接询问当前 AI Agent：

如何安装 anthropics/claude-plugins-official#build-mcp-server？

也可以指定 Agent 询问：

如何在 Claude Code 中安装 anthropics/claude-plugins-official#build-mcp-server？

如何在 Codex 中安装 anthropics/claude-plugins-official#build-mcp-server？

如何在 Cursor 中安装 anthropics/claude-plugins-official#build-mcp-server？

让当前 Agent 根据自己的 Skill 加载与管理机制来指导安装，通常比手动复制文件更稳妥。

二、安装后如何使用

安装后不需要特殊命令触发。你只需在对话中描述要构建的 MCP Server 需求，Agent 会按需加载该 Skill 并按其流程推进。适合交给它的任务：设计 MCP Server 结构、生成工具定义与 Schema、搭传输层、写处理逻辑、调试联通。

自然语言使用示例：

使用 build-mcp-server，帮我为公司的内部订单 API 设计一个 MCP Server，先暴露“查询订单”和“创建退款”两个工具。

用 build-mcp-server，为一个 SQLite 数据库设计 MCP Server，提供查询表和读取数据的能力，用 stdio 传输。

帮我用 build-mcp-server 搭建一个 MCP Server 骨架，使用 TypeScript 和官方 MCP SDK，先给出项目结构和工具定义。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。优先做法：

– 使用对应 Agent / Skill 管理器提供的删除或禁用方式移除该 Skill
– 或直接询问当前 Agent：

如何卸载 anthropics/claude-plugins-official#build-mcp-server？

如果没有统一卸载命令，直接询问当前 Agent 如何移除通常更稳妥。官方未提供统一卸载命令，请勿依赖虚构命令。

常见问题

1. 这个 Skill 会自动帮我运行和部署 MCP Server 吗？

不会。它提供的是构建过程中的指导、结构和代码建议。运行、部署、托管都需要你自己完成；如果你的 Agent 开了 Shell 权限，它可能会帮你运行测试命令，但这不是 Skill 替你部署。

2. 可以同时安装到多个 Agent 吗？

通常可以。Skill 的安装是各 Agent 独立管理的，你可以分别安装到 Claude Code、Codex、Cursor 等环境中。不同 Agent 的加载机制和兼容程度不同，需分别验证。

3. 安装后 Agent 没有识别到这个 Skill，怎么办？

先确认安装是否成功（对应 Agent 的 Skill 列表或管理界面能看到它）。若看不到，通常是 Skill 目录位置不对或 Agent 未重新加载。可以让 Agent 自己检查：「列出当前可用的 Skills」，或直接问它「anthropics/claude-plugins-official#build-mcp-server 是否已安装」。

4. Skill 更新后需要重新安装吗？

取决于 Agent 的管理方式。有些 Agent 支持自动更新或更新命令，有些需要重新拉取。官方未给出统一说明，建议询问当前 Agent 如何更新该 Skill。

5. 中国大陆使用是否有网络要求？

Skill 安装需要访问仓库；构建 MCP Server 时需要按需访问依赖源（如 npm、PyPI）。这些源在中国大陆的访问速度可能受影响，必要时可配置镜像或代理。Skill 本身没有专门的中国大陆版本。

6. 它会修改我已有的项目文件吗？

有可能，取决于你如何授权。为了降低风险，建议在独立目录或新分支中构建，或限制 Agent 的写入 / Shell 权限，让它只输出代码由你手动应用。

7. 构建出来的 MCP Server 可以直接上生产吗？

不建议直接上生产。Skill 帮你快速搭建，但生产环境需要额外关注：鉴权与授权、输入校验、可访问数据的范围、错误处理、日志与监控。这些应由你和团队在接入前完成审查。