Anthropic 官方 mcp-builder 技能更新:改教 MCP TypeScript SDK v2
Anthropic 官方 skills 仓库 10 月 28 日更新了 mcp-builder 技能,新增基于 `@modelcontextprotocol/server` 的 v2 TypeScript 指南。技能要求新项目用 v2;已依赖 v1 的项目只提醒一次可用 codemod 迁移,除非用户要求,否则继续用 v1。新指南围绕 SDK 官方示例重写,包含服务端工厂函数、stdio 与 HTTP 完整示例、bearer 鉴权和一个自检脚本。
适用:Claude Code
能做什么
- 指导 Agent 调研目标 API、规划工具清单后再实现 MCP 服务
- 提供 TypeScript(SDK v2 与 v1)和 Python(FastMCP)实现指南
- 给出工具命名、分页、错误信息和 annotations 的设计规范
- 生成评测问题,检验模型能否用该服务完成真实任务
好在哪里
- 按项目现有依赖选择 SDK 版本,不擅自迁移,只提醒一次
- 自带可运行的自检脚本和质量检查清单,交付前能机械验证
- 参考文档按阶段按需加载,不必一次读完
本次更新
- 新增 reference/node_mcp_server_v2.md,基于 @modelcontextprotocol/server
- SKILL.md 说明如何在 v1 与 v2 之间选择,v1 项目提示可用 codemod 迁移
- v2 指南新增自检脚本、bearer 鉴权示例和 v1 到 v2 对照表
安装 / 启用
/plugin marketplace add anthropics/skills,然后 /plugin install example-skills@anthropic-agent-skills
要点
- 技能把 MCP 服务开发分为调研规划、实现、评审测试、编写评测四个阶段
- v2 需要 Node.js 20+ 和 zod 4.2.0 以上;指南提醒每次调用都要返回新的 McpServer 实例,共享实例在并发请求时会出错
- 自检脚本以客户端身份启动构建产物、调用工具,并检查非法输入会被拒绝
- 第四阶段要求写 10 个只读、可验证的问答作为评测
为什么值得关注
技能是纯 Markdown 指南,与模型无关,用开源命令行 Agent 也能读;团队给内部系统写 MCP 服务时,可直接用它约束结构和验证流程。
来源
原文
Update mcp-builder skill: teach v2 of the MCP TypeScript SDK (#2087)
GitHub · github.com · 2026-10-28
原文
anthropics/skills · mcp-builder/SKILL.md
GitHub · github.com
### [Anthropic 官方 mcp-builder 技能更新:改教 MCP TypeScript SDK v2]({{URL}})
Anthropic 官方 skills 仓库 10 月 28 日更新了 mcp-builder 技能,新增基于 `@modelcontextprotocol/server` 的 v2 TypeScript 指南。技能要求新项目用 v2;已依赖 v1 的项目只提醒一次可用 codemod 迁移,除非用户要求,否则继续用 v1。新指南围绕 SDK 官方示例重写,包含服务端工厂函数、stdio 与 HTTP 完整示例、bearer 鉴权和一个自检脚本。
- 技能把 MCP 服务开发分为调研规划、实现、评审测试、编写评测四个阶段
- v2 需要 Node.js 20+ 和 zod 4.2.0 以上;指南提醒每次调用都要返回新的 McpServer 实例,共享实例在并发请求时会出错
- 自检脚本以客户端身份启动构建产物、调用工具,并检查非法输入会被拒绝
- 第四阶段要求写 10 个只读、可验证的问答作为评测
**为什么值得关注**:技能是纯 Markdown 指南,与模型无关,用开源命令行 Agent 也能读;团队给内部系统写 MCP 服务时,可直接用它约束结构和验证流程。
来源:[Update mcp-builder skill: teach v2 of the MCP TypeScript SDK (#2087)](https://github.com/anthropics/skills/commit/ca45fc496a3436251f191354091d557da31c15b5);[anthropics/skills · mcp-builder/SKILL.md](https://github.com/anthropics/skills/blob/main/skills/mcp-builder/SKILL.md)