MCP 服务器构建向导
帮助开发者在编写代码前确定 MCP 服务器的部署、工具设计、框架与认证方案。
文档覆盖 OAuth、受众校验、禁止令牌透传、密钥不得明文保存、elicitation 不得索取密码/API 密钥,以及破坏性操作确认等安全要点;但默认远程脚手架可无认证运行,示例使用 0.0.0.0,通用数据流、权限最小化、回滚和副作用确认仍需实现者补充,因此扣分。
阶段化流程、部署决策表、能力检查、fallback、取消处理、错误清单和版本敏感声明较清晰;但核心示例依赖未定义的 upstreamApi、rankActions、dispatch 等占位实现,未提供该技能专属测试套件或可静态验证的关键路径 CI,因此按静态上限保守扣分。
明确覆盖云 API、本地进程、桌面应用、UI、OAuth、工具数量和多种部署模型,并说明部分不适用边界;但触发条件仍较宽泛,未提供中文使用指导,也未证明对中国大陆网络访问 Claude 文档、Cloudflare 或相关服务的适配,因此扣分。
SKILL.md 采用发现、部署、工具设计、框架、交接、测试发布和参考文件的分层结构,包含版本字段、版本账本、示例、限制和 Apache-2.0 仓库许可背景;但技能自身缺少变更日志、明确维护负责人、依赖版本锁定和系统化故障排查路径,因此扣分。
该技能能帮助开发者完成 MCP 形态选择、工具模式选择、框架选择并获得 TS/Python/Cloudflare 起始脚手架,核心任务方向明确;但输出不是可直接运行的完整项目,存在外部文档抓取和多处业务占位符,仍需较多实现与验证,因此按静态上限评为中等并扣分。
存在引用路径、版本敏感声明、检查命令、部署清单和 Inspector/CLI 测试建议,具备一定审计线索;但本次仅有静态文件材料,没有该技能专属测试结果、第三方执行证据或多源交叉验证,因此不超过静态上限并扣分。
- 默认远程示例允许无认证部署;生产环境必须明确认证、授权、令牌受众校验、上游凭据隔离和数据流。
- 文档要求先抓取 Claude 文档,且关键服务和部署示例依赖海外网络;中国大陆网络环境下可能无法稳定访问或验证。
- 示例中的 upstreamApi、rankActions、dispatch 等未实现,不能据此视为可直接运行或已测试。
- 破坏性操作的确认、回滚和错误恢复需要在具体服务器中逐项实现,技能本身未提供完整通用机制。
它能做什么 & 适用场景
这是 Anthropic 官方 Claude Code 插件目录中的一个开发技能,专门指导 MCP 服务器的设计与构建。它先了解外部连接对象、用户范围、工具数量、交互界面需求和上游认证方式,再推荐远程 HTTP、MCPB 或本地 stdio 部署模型。随后它选择合适的工具设计模式和 TypeScript SDK 或 FastMCP 框架,并根据方案进行脚手架搭建或移交给专门技能。它还覆盖在 Claude 中测试、审核和提交到 Anthropic Directory 的后续步骤。
它要求先回答五类发现问题,并在提供建议前读取 Claude 连接器文档的完整导出。它根据场景在远程 streamable HTTP、MCP app、MCPB 和本地 stdio 之间推荐一种部署方式,选择“每个操作一个工具”或“搜索加执行”模式,并推荐官方 TypeScript SDK 或 Python FastMCP 3.x。它可根据部署方案内联搭建远程 HTTP 或本地 stdio 原型,也可将 MCP app 或 MCPB 方案移交给 build-mcp-app 或 build-mcpb 技能。它还提供认证、工具设计、资源与提示、能力声明、部署、测试、审核和提交相关的参考文件与步骤。
- 正在包装 SaaS、REST 或 GraphQL API,并需要决定是否部署为远程 MCP 服务器的开发者。
- 需要连接本地文件、桌面应用、localhost 服务或操作系统能力的开发者。
- 包装拥有数十到数百个端点的大型 API,并需要避免工具列表挤占 Claude 上下文的团队。
- 想为 Claude 构建带表单、搜索列表、图表或实时面板的 MCP app 的开发者。
- 希望先制作个人 MCP 原型,再评估是否升级为 MCPB 或远程部署的开发者。
优缺点一览
- 先做场景发现,再决定部署形态,可减少早期选型错误。
- 覆盖远程 HTTP、MCPB、本地 stdio、MCP app、elicitation 和大型 API 工具设计。
- 明确推荐官方 TypeScript SDK 与 Python FastMCP 3.x,并提供多份参考文件。
- 包含 Claude 测试、审核标准和目录提交流程。
- 在 Phase 1 问题得到回答前不会开始脚手架搭建。
- 指导要求读取外部 Claude 文档和多个参考文件,网络或文件访问受限时可能无法完整执行。
- 源材料没有提供该技能的测试套件、费用信息或独立安装命令。
- 部分主机能力仍存在兼容性 caveat,例如 elicitation 支持正在推出。
如何安装
该技能属于 anthropics/claude-plugins-official 集合。README 给出的 Claude Code 安装命令是 /plugin install {plugin-name}@claude-plugins-official,但源材料未明确给出此技能对应的 plugin-name,也未说明独立安装步骤。
如何使用
在已安装该插件集合的 Claude Code 中,使用描述中的触发语句,例如 Build an MCP server that wraps our REST API、Create an MCP integration 或 Expose these tools to Claude。技能会先询问连接对象、用户范围、操作数量、交互需求和认证方式;完成这些决策后再建议部署模型、工具模式和框架,并进行搭建或移交。
对比同类
它明确比较远程 streamable HTTP、MCPB 和本地 stdio 三种部署路径,也比较官方 TypeScript SDK 与 Python FastMCP 3.x;没有提供与其他独立产品或技能的完整竞品比较。