官方示例技能anthropics/skills 官方仓库

mcp-builder:构建 MCP 工具服务

面向开发者的技能:指导你把已有 API 或本地脚本做成 MCP 服务器,让各类 AI 客户端直接调用。

Claude Code 等支持 Skills 的客户端anthropics/skillsMCP SDK
mcp-builder:构建 MCP 工具服务

能做什么

  • 按 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 工具生态的工程师。

注意事项

  • 写操作类工具(改数据、发通知)务必加确认与权限控制,不要裸奔上线
  • 接口密钥走环境变量,不要写进代码或技能文件里
← 返回 Skills 解析