Skip to main content
代理技能 是可移植的指令集,它们为 AI 编码助手提供执行任务所需的领域知识。对于 MCP 开发,它们会编码设计决策(部署模式、工具模式、认证),以便你的代理可以询问你的用例,并搭建一个适合的服务器。

可用技能

有一套参考性的 MCP 开发技能可通过 mcp-server-dev 插件获取。 它提供三个组合技能: 每个技能都附带一个 SKILL.md 文件以及一个 references/ 文件夹,其中包含支持材料(认证流程、工具设计模式、组件模板、清单 schema),代理会按需读取这些内容。这些文件采用开放格式,并可与任何实现了该标准的代理配合使用。例如,要在 Claude Code 中安装它们:
对于其他代理,请查看你的技能或扩展目录,或者将技能目录SKILL.md 加上 references/)克隆到你的代理技能位置。

开始构建

安装好这些技能后,请让你的代理帮助你构建一个 MCP 服务器。入口技能会在自然语言请求时触发,或者你也可以使用代理的技能调用语法直接调用它。 该技能在编写任何代码之前会先进行一个简短的发现阶段。你可以预期会被问到以下问题:
  • 它连接什么 —— 云 API、本地进程、文件系统、硬件
  • 谁会使用它 —— 只有你、你的团队,还是任何安装它的人
  • 操作范围大小 —— 少量操作,还是对大型 API 的封装
  • 用户交互需求 —— 纯文本结果还是丰富的 UI 小部件
  • 上游认证 —— API 密钥、OAuth 2.0,或无认证
如果你的开场消息已经涵盖了这些内容,代理就会直接跳到推荐步骤。

部署路径

基于发现结果,技能会推荐以下四种路径之一,并相应地搭建脚手架: 远程 HTTP with SSE
是包装云 API 的默认选择。零安装成本,一个部署服务所有用户,并且 OAuth 流程可以正常工作,因为服务器可以处理重定向和令牌存储。参考技能包含 Cloudflare Workers 和可移植的 Express/FastMCP 设置脚手架。
MCP 应用 扩展了服务器,在聊天中渲染交互式小部件,例如可搜索的选择器、图表和实时仪表板。当纯文本输出不合适时,技能会切换到 build-mcp-app MCP Bundles (MCPB) 将本地服务器及其运行时打包成一个单独的 .mcpb 归档文件,因此用户无需设置 Node 或 Python 即可安装它。当服务器必须访问用户机器时,请使用此路径:读取本地文件、控制桌面应用,或与 localhost 服务通信。技能会切换到 build-mcpb 本地 stdio 仍可用于原型开发,并注明了在准备分发时升级到 MCPB 的路径。

下一步

一旦你的代理搭建好服务器框架,就可以迭代工具描述和错误 处理,然后进行测试并发布:

MCP 检查器

交互式测试你的服务器的工具、资源和提示

连接到客户端

通过本地或远程配置将你的服务器接入 MCP 客户端

发布到注册表

让你的服务器可以在 MCP 注册表中被发现