使用 Agent Skills 构建
社区译文;来源: MCP 80041ab0
Agent Skills 是可移植的指令集,可为 AI 编码助手提供完成特定任务所需的领域知识。在 MCP 开发中,它们会编码部署模型、工具模式和授权等设计决策,让 Agent 能够了解你的用例,并搭建与之匹配的服务器。
可用 Skills
MCP 开发 Skills 的参考实现以 mcp-server-dev 插件
形式提供。该插件包含三个可组合的 Skill:
| Skill | 用途 |
|---|---|
build-mcp-server | 入口。了解用例,选择部署模型和工具设计模式,并路由到专用 Skill。 |
build-mcp-app | 添加可在聊天中内联呈现的交互式 UI 组件,例如表单、选择器和仪表盘。 |
build-mcpb | 将本地 stdio 服务器及其运行时打包,使用户无需安装 Node 或 Python 即可使用。 |
每个 Skill 都包含一个 SKILL.md 文件和一个存放支持材料的 references/ 目录,例如授权流程、工具设计模式、组件模板和清单 schema,Agent 会按需读取这些内容。这些文件遵循开放格式,可用于任何实现该标准的 Agent。例如,在 Claude Code 中可执行以下命令安装:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install mcp-server-dev对于其他 Agent,请查看其 Skills 或扩展目录,也可以将 Skill 目录
(包括 SKILL.md 和 references/)克隆到该 Agent 的 Skills 位置。
开始构建
安装 Skills 后,让 Agent 帮助你构建 MCP 服务器。入口 Skill 会由自然语言请求触发,你也可以使用 Agent 的 Skill 调用语法直接调用它。
该 Skill 会在编写代码前进行简短的需求发现。它通常会询问:
- 连接对象:云 API、本地进程、文件系统还是硬件
- 使用者:只有你、你的团队,还是任何安装它的人
- 操作范围大小:少量操作,还是对大型 API 的封装
- 用户交互需求:纯文本结果、通过信息收集 提供结构化输入,还是富 UI 组件
- 上游授权:API key、OAuth 2.0,还是无需授权
如果你的初始消息已经包含这些信息,Agent 会直接进入方案推荐阶段。
部署路径
Skill 会根据需求发现结果推荐以下四种路径之一,并据此搭建项目:
远程 Streamable HTTP 是封装云 API 时的默认选择。它无需用户安装,一次部署即可服务所有用户,而且服务器可以处理重定向和 token 存储,因此 OAuth 流程能够正常工作。参考 Skill 提供了 Cloudflare Workers 以及可移植的 Express/FastMCP 项目脚手架。
MCP Apps
通过可在聊天中呈现的交互式组件扩展服务器,例如可搜索的选择器、图表和实时仪表盘。当信息收集
的简单表单限制无法满足需求时,Skill 会转交给 build-mcp-app。
MCP Bundles (MCPB)
将本地服务器及其运行时打包为单个 .mcpb 归档,使用户无需配置 Node 或 Python 即可安装。当服务器必须访问用户机器时,例如读取本地文件、驱动桌面应用或连接 localhost 服务,应选择此路径。Skill 会转交给 build-mcpb。
本地 stdio 仍可用于原型开发,并会提示在准备分发时升级到 MCPB。
后续步骤
Agent 完成服务器脚手架后,继续迭代工具描述和错误处理,然后测试并发布:
MCP Inspector
以交互方式测试服务器的工具、资源和提示词
连接到客户端
通过本地或远程配置将服务器接入 MCP 客户端
发布到 Registry
让你的服务器可在 MCP Registry 中被发现