由于 trendforge.devlive.top 访问受限,请切换到 trendforge.devlive.org 域名

MCP 技能扩展快速开始

快速体验 Model Context Protocol 技能扩展,了解技能发现与分配的基本流程。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js 18.0.0 或更高 必需

所需工具

npm

用于安装依赖和运行脚本

必需

操作步骤

1

克隆仓库

将项目仓库克隆到本地计算机。

克隆项目代码
git clone https://github.com/modelcontextprotocol/ext-skills.git

预期结果::目录 'ext-skills' 已创建,包含项目文件。

确保已安装 Git。

2

安装依赖

进入项目目录并安装必要的 Node.js 依赖。

进入项目目录
cd ext-skills
安装项目依赖
npm install

预期结果::依赖安装完成,无错误信息。node_modules 目录已创建。

如果 npm 安装速度慢,可以考虑使用镜像源。

3

运行示例

运行一个快速示例,体验技能发现或分配的基本流程。项目包含示例服务器和客户端脚本。

运行快速开始示例(假设的脚本,实际命令请参考项目 package.json)
npm run example:quickstart

预期结果::在终端中看到技能发现或分配的消息,例如 'Skill discovered: example-skill' 或客户端与服务器成功交互的日志。

请先查看 package.json 文件,了解可用的示例脚本。如果命令不存在,请参考 README 或文档中的示例运行说明。

4

查看规范文档

了解技能扩展的核心概念和协议规范。

用默认编辑器打开规范文件(macOS)
open specification/stable/skills.mdx
用默认编辑器打开规范文件(Windows)
start specification/stable/skills.mdx

预期结果::规范文件在编辑器中打开,可以阅读技能扩展的详细定义。

可以使用任何文本编辑器或浏览器(如果 .mdx 能渲染)打开此文件。

验证成功

确认快速开始示例运行成功并理解了基本流程。

终端中显示了技能发现或分配的示例输出
成功打开了规范文件并浏览了内容

快速提示

学习

阅读 `specification/stable/skills.mdx` 是理解该扩展的最佳方式。

社区

加入 Discord 服务器 `skills-over-mcp-wg` 可以参与社区讨论。

深入

查看 `docs/` 目录下的决策日志和设计原理,了解设计背后的思考。

常见问题

1

运行 `npm run example:quickstart` 时提示脚本未找到。

检查 `package.json` 文件中的 `scripts` 部分,确认可用的示例命令名称,并替换命令中的脚本名。

2

依赖安装失败或报错。

确保 Node.js 版本符合要求(≥18)。尝试删除 `node_modules` 和 `package-lock.json` 后重新运行 `npm install`。

3

克隆仓库时连接失败。

检查网络连接,或尝试使用 SSH 克隆(如果已配置 SSH 密钥)。

下一步

阅读官方概述文档

访问 modelcontextprotocol.io/extensions/skills/overview 获取更详细的示例和消息流。

查看实现列表

查看 `docs/` 目录下的 implementations 文档,了解有哪些服务器、SDK 和主机支持此扩展。

参与贡献

阅读 CONTRIBUTING.md,通过提交 Pull Request 或 Issue 参与项目开发。

助手