官方示例技能anthropics/skills 官方仓库
mcp-builder:构建 MCP 工具服务
面向开发者的技能:指导你把已有 API 或本地脚本做成 MCP 服务器,让各类 AI 客户端直接调用。
Claude Code 等支持 Skills 的客户端anthropics/skillsMCP SDK
能做什么
- 按 MCP 规范设计工具:名称、参数 schema、返回结构一次想清
- 用官方 SDK 搭出可运行的 MCP 服务器骨架并跑通本地联调
- 把内部接口、数据库查询、运维脚本包装成 AI 可调用的工具
- 讲解工具粒度与描述写法:描述写得好,AI 才选得对、传得准
安装方式
# 1. 克隆官方示例仓库 git clone https://github.com/anthropics/skills.git # 2. 把 mcp-builder 文件夹整个拷进个人技能目录 mkdir -p ~/.claude/skills cp -r <仓库路径>/mcp-builder ~/.claude/skills/ # 3. 重启客户端或新开会话即可
动手前先想清楚要暴露哪些工具、每个工具的权限边界;技能会按你的清单来设计,而不是替你决定业务。
SKILL.md 结构拆解
--- name: mcp-builder description: 构建 MCP(Model Context Protocol)服务器:设计工具接口、用官方 SDK 实现并联调。当用户要开发 MCP 工具、把接口给 AI 调用时使用。 --- # MCP 构建 ## 设计顺序 1. 先列工具清单:每个工具一句话说清「做什么、入参、出参」 2. 选 SDK 与传输方式,搭最小可运行骨架 3. 逐个实现工具并本地联调,最后补错误处理与日志 ## 描述写法 - 工具描述写给 AI 看:说清适用场景和不适用场景 - 参数给类型、必填项与示例,避免裸字符串传一切
拆解 · 重点看 description:客户端不会预先读完每个技能的正文,而是先看全部技能的 name 与 description,判断这次请求和哪个技能相关、要不要调用。所以 description 必须同时写清「做什么」和「何时用」——写得太空泛会误触发,写得太窄又永远触发不了,这是整个技能设计里最关键的一行。
下面是按 Agent Skills 官方规范整理的结构示意,用来帮你看懂每个字段的作用,不是官方原文照搬。
调用话术示例
这样说 · 「我想把公司内部的订单查询接口做成 MCP 工具,让 AI 能按订单号查状态。带我从设计工具清单开始,一步步搭出来。」
适合谁
想把自家系统能力开放给 AI 的开发者与团队;做 Agent 工具生态的工程师。
注意事项
- 写操作类工具(改数据、发通知)务必加确认与权限控制,不要裸奔上线
- 接口密钥走环境变量,不要写进代码或技能文件里