Skills生态第2轮,照例做单件开膛。这次选的是官方件里最“硬”的一枚:mcp-builder——Anthropic随 anthropics/skills 仓库分发的教学型技能,职责是教会Claude从零造一个MCP服务器。核心发现一句话:它是官方件中少见的“自带考卷”设计——门牌极薄、正文只留流程骨架,肌肉全在两份技术栈专列和一册最佳实践里,最后还塞了一个评分脚本,让Agent造完服务器自己考自己。本文逐文件拆到行,并提炼四个可抄的写法模式。
拆解底料说明:本文开膛的对象是本机经 Anthropic 官方插件市场(anthropic-agent-skills)装件后的原件目录,文件树为实测一 手材料;本期会话联网核查通道受限,因此凡无法双源核实的数字(Star数、下载量)一律不写,涉及原文字句处以“大意”标注,逐字引用请以仓库当前版本为准。
如果说 skill-creator 是官方的“造件机”(教Claude写SKILL.md),那 mcp-builder 就是官方的“造服务器教练”(教Claude写MCP服务器)。MCP(Model Context Protocol)是Anthropic推出的工具接入协议,如今已是Agent连工具的事实标准——每个想把自家API接进Claude生态的开发者,都要写一个MCP服务器。这个Skill干的就是这件事:你说“帮我写个MCP服务器”,它接管整个工程。
值得注意的位置差异:skill-creator 教的是“元层”手艺(怎么写技能本身),mcp-builder 教的是“业务层”手艺(怎么写真实世界里的服务器代码)。两者一个管门规、一个管车间,官方把两条造物线分得很开,避免了触发词打架。
开膛第一步,实测目录树如下——10个文件,四个职责区:
mindmap
root((mcp-builder))
SKILL.md
LICENSE.txt
reference
mcp_best_practices.md
python_mcp_server.md
node_mcp_server.md
evaluation.md
scripts
evaluation.py
connections.py
requirements.txt
example_evaluation.xml
这个骨架本身就是一堂课。门面只有 SKILL.md 一个文件;reference/ 四份文档分两类——一册横贯的最佳实践(mcp_best_practices.md),两份按语言分的代码专列(python_mcp_server.md、node_mcp_server.md),外加一张考卷说明(evaluation.md);scripts/ 四件套则是全官方件里罕见的配置——技能包里自带评分工具。LICENSE.txt 随包分发,说明市场装件把授权也打包进件,这是官方件的规格自觉。
官方件门牌只有 name 和 description 两个字段,没有额外的暗字段。description 是触发面设计的范本,大意覆盖四类场景:新建MCP服务器、给已有服务器加工具、用 Python(FastMCP)或 TypeScript SDK 做MCP开发、咨询MCP设计规范与最佳实践。
拆它的门牌写法,有三处值得抄:
SKILL.md 正文的第一个动作不是讲课,是问路:你要造的是Python服务器还是Node服务器?然后各给一个指针——读对应的 reference 专列。这是典型的“门卫式分流”结构:
flowchart TD
A["用户要造MCP服务器"] --> B["门牌description命中"]
B --> C["加载SKILL.md骨架"]
C --> D{"选什么技术栈"}
D -->|Python| E["读python专列"]
D -->|TypeScript| F["读node专列"]
E --> G["按最佳实践写工具"]
F --> G
G --> H["connections.py连上自测"]
H --> I["evaluation.py跑考卷"]
I --> J{"分数过线"}
J -->|过| K["交付服务器代码"]
J -->|不过| G
正文自己只保留少量全局骨架:MCP三原语(tools、resources、prompts)的分工、写完必须测试的强制流程、以及指向评估脚本的收尾指令。它把正文当索引用,不当课本用——这是官方件在上下文经济学上的标准答案:SKILL.md 常驻上下文,每多写一行废话,就是每轮对话多烧一行token;reference 按需加载,厚一点也不亏。
这是最厚的一份,写的不是某个API怎么调,而是设计纪律。大意为:
get_user 而非 getUser 或 get-data。理由很直白:命名是Agent选择工具的第一线索,混乱命名等于让模型猜谜。这份文件的本质,是把Anthropic内部写MCP服务器的review标准文档化。对人类开发者同样值回票价——很多团队自己的MCP规范都没写这么细。
python_mcp_server.md 与 node_mcp_server.md 结构对称,各讲一栈的完整写法:环境与依赖初始化、服务器实例与 lifespan 管理、工具注册(Python栈是 @mcp.tool 装饰器风格,Node栈是 SDK 的 server.tool 注册加 zod 校验)、资源与提示的挂载、本地调试方法。专列的好处是零跳转:Agent选了栈,一路读到底就能动笔,不用在两套术语间换脑子。
最容易被忽略但最见设计功力的一份。它规定造完服务器后如何用 scripts/evaluation.py 打分、报告落成什么格式。官方把“验收”写进了交付流程——技能不止管“造出来”,还管“造得合不合格”。
scripts/ 四件套是这件的灵魂:
这个设计回答了Skills生态的一个老大难:“造完谁来验?”多数技能的答案是“靠模型自觉”,而 mcp-builder 的答案是把考官写进件里——流程末端挂着强制验收,分数不过线就回炉重写,形成闭环。对想写技能的读者,这是本文最值钱的一个模式:你写的技能管什么,就把那个领域的“验收动作”做成脚本一并打包,比一万句“请确保质量”都管用。
| 维度 | 星级 | 依据 |
|---|---|---|
| 功能完整度 | ★★★★★ | 从空目录到过审交付全流程覆盖,双栈通吃;短板是不出Python/Node之外的语言 |
| 设计质量 | ★★★★★ | 渐进披露、门卫分流、自带考卷,官方件设计范本级 |
| 实战效果 | ★★★★☆ | 对MCP新手是显著加速器;老手增量有限,规范约束有时显啰嗦(社区反馈口径,未经独立数据核实) |
| 上手难度 | ★★★★☆ | 零配置,说话即触发;需要用户对MCP概念有基本认知 |
| 社区活跃度 | ★★★★☆ | 官方仓库长期维护成员,随市场装件持续分发;具体热度数字本期未做独立核实 |
适用:从零写一个Python或TypeScript的MCP服务器;给现有服务器补工具;评审既有服务器的命名与响应设计;想学SKILL.md写法的技能作者(把它当字帖)。
不适用:写MCP客户端(它只教练服务器侧);Go/Rust等其他语言的MCP实现(专列只铺了双栈,其他语言硬上等于脱模);不打算接入MCP生态的普通API开发——门牌押的是MCP关键词,日常API需求压根唤不醒它,这是设计的自觉而非缺陷。
装件方式(本机即为官方市场装件,实测在册):
# 方式一:Claude Code 内进插件市场,安装 anthropic-agent-skills,勾选 mcp-builder
/plugin
# 方式二:手动装——克隆官方仓库,拷目录
git clone https://github.com/anthropics/skills.git
cp -r skills/mcp-builder ~/.claude/skills/
唤它不需要斜杠命令,直接说人话即可:“帮我写一个MCP服务器,提供天气查询工具”、“给我的MCP server加一个删除订单的工具”、“评审一下这个MCP服务器的工具命名”。
mcp-builder 的过人之处不在“会写MCP”,而在承认模型会偷懒:它不叮嘱“请遵循最佳实践”,而是把规范写成必读的reference;不指望“请自行测试”,而是把考官塞进scripts。把约束做成结构,把验收做成脚本——这十二个字,是这件留给所有技能作者的字帖。下一轮按排期进入开发者效率类横评,值得期待谁会撞上这套“自带考卷”的标准。
mcp-builder/ 全部10个文件树 — 本文逐文件拆解的一手材料[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
