技术文档摘要

技能 MCP 服务器

这是一个模型上下文协议（MCP）服务器，使AI代理能够动态查询和加载技能。技能是模块化包，通过专门的知识、工作流程和工具集成来扩展代理的能力。

关于技能

技能是LLMs的一种新型工具，允许它们按需使用某些技能。这些通常会取代MCPs，但目前MCPs具有比技能更广泛的兼容性，因为技能仅适用于Anthropic的Claude。

此MCP服务器通过允许任何与MCP兼容的代理从技能库中发现、查询和加载技能来弥合这一差距。

功能

• 列出技能：发现所有可用技能及其元数据
• 获取技能详情：检索完整的技能定义，包括SKILL.md内容
• 加载资源：访问捆绑的资源，如脚本、参考和资产

安装

该项目使用UV进行依赖管理。

选项 1：克隆并本地安装

# 克隆仓库
git clone https://github.com/armstrys/skills-mcp.git
cd skills-mcp

# 安装依赖
uv sync

# 运行MCP服务器
uv run skills-mcp

选项 2：直接从Git运行

无需克隆即可直接从Git仓库运行服务器：

# 直接从Git运行MCP服务器
uvx --from git+https://github.com/armstrys/skills-mcp.git skills-mcp

选项 3：作为包安装

# 安装包
pip install git+https://github.com/armstrys/skills-mcp.git

# 运行MCP服务器
skills-mcp

使用

MCP服务器提供三个主要工具：

skills_list

列出.skills目录中的所有可用技能。

参数：

• limit（可选）：返回的最大技能数量（默认：50）
• offset（可选）：分页时跳过的技能数量（默认：0）

skills_get

获取特定技能的详细信息。

参数：

• skill_name：要检索的技能名称

skills_load_resource

从技能中加载特定资源文件。

参数：

• skill_name：包含资源的技能名称
• resource_path：相对于技能目录的资源文件路径

技能目录结构

服务器期望技能组织在.skills/目录中，具有以下结构：

.skills/
├── skill-name/
│   ├── SKILL.md （必需）
│   ├── scripts/ （可选）
│   ├── references/ （可选）
│   └── assets/ （可选）

每个技能必须有一个SKILL.md文件，其中包含至少name和description字段的YAML前言。

开发

运行测试

uv run pytest

构建

uv build

许可证

查看各自SKILL.md文件中的单独技能许可证。 </中文翻译>