STARWARCLOUD STARWAR.AI
返回市场
技能-mcp

技能-mcp

作者：skills-mcp6 星标更新：2025-10-20
安装使用来源：spider==github.com

项目介绍

Skills MCP

通过模型上下文协议（Model Context Protocol），赋予任何AI代理访问模块化、可重用技能的能力，将其转变为领域专家。

灵感来源：Claude Skills：此MCP服务器将Claude的Skills模式引入到任何兼容MCP的代理中。

  • 是什么：一个MCP服务器，将Claude的Skills格式引入到任何兼容MCP的代理中。
  • 为什么：创建一次技能，随处使用——跨越Claude、VS Code、Cursor以及任何MCP工具。
  • 如何：指向你的技能目录，代理会自动发现它们。

快速设置

最快的方式是使用npx。选择你的平台：

<details> <summary><strong>Claude Code</strong></summary>

在项目中创建.mcp.json或全局创建~/.claude.json：

{
  "mcpServers": {
    "skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/绝对路径/到/技能"]
    }
  }
}
</details> <details> <summary><strong>Claude for Desktop</strong></summary>

创建~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "skills-mcp": {
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/绝对路径/到/技能"]
    }
  }
}
</details> <details> <summary><strong>Cursor</strong></summary>

在项目中创建.cursor/mcp.json或全局创建~/.cursor/mcp.json：

{
  "mcpServers": {
    "skills-mcp": {
      "command": "npx",
      "args": ["-y", "skills-m-技能目录路径-cp", "-s", "/绝对路径/到/技能"]
    }
  }
}
</details> <details> <summary><strong>VS Code</strong></summary>

在项目中创建.vscode/mcp.json：

{
  "servers": {
    "skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/绝对路径/到/技能"]
    }
  }
}
</details>

替换 /绝对路径/到/技能 为你实际的技能目录路径。

尝试一下

  1. 在你的代理中启动MCP服务器。
  2. 推荐：在每个会话开始时运行/init-skills提示，以提供关于Skills MCP工作流程的背景指导。
  3. 替代方案：只需请求代理完成任务，它会在需要时发现并使用技能。

就这样！你的代理现在可以发现并使用技能了。

获取示例技能

想用现成的技能试试吗？Anthropic维护了一个示例技能集合，你可以使用npx degit立即将其带入你的项目：

# 获取技能创建者技能
npx degit anthropics/skills/skill-creator skills/skill-creator

# 获取MCP构建者技能
npx degit anthropics/skills/mcp-builder skills/mcp-builder

这些命令将直接下载技能到你的skills/目录中，不带任何git历史记录。浏览Anthropic技能仓库查看所有可用示例。

代理指令设置

希望Skills MCP指导始终存在于你的代理上下文中？导出指令：

推荐：使用AGENTS.md支持广泛的代理：

npx -y skills-mcp instructions >> AGENTS.md

对于没有AGENTS.md支持的代理：

# Claude Code
npx -y skills-mcp instructions >> CLAUDE.md

使用指令文件还是/init-skills提示

  • 使用指令导出如果你希望技能指导始终出现在每次对话中。
  • 使用/init-skills提示如果你希望最小化上下文使用，并仅在需要时加载指导。

两种方法使用相同的内容——根据你对上下文管理的偏好进行选择。

理解技能

<details> <summary><strong>什么是技能？</strong></summary>

技能是模块化的、自包含的包，将通用的AI代理转变为特定领域的专家。可以将它们视为特定领域或任务的“入职指南”——它们提供了模型无法完全掌握的过程知识。

示例：PDF处理技能可能包括：

  • 提取文本和填写表单的说明
  • 可靠的PDF操作Python脚本
  • 高级用例的参考文档
  • 生成文档的模板文件

无需在每次对话中解释PDF处理，只需安装一次技能，代理就知道何时及如何使用它。

</details> <details> <summary><strong>为什么是Skills MCP？</strong></summary>

虽然Claude内置了Skills支持，但这个MCP服务器将同样的能力带给了其他代理：

  • 普遍兼容性：任何兼容MCP的代理现在都可以使用Claude Skills。
  • 统一管理：单一技能目录适用于所有代理和平台。
  • Claude可选：当使用Claude Desktop或Claude Code时，你可以禁用此服务器并使用内置Skills。
  • 逐步披露：技能按阶段加载信息，最小化上下文使用。

关键优势：在Claude格式下创建一次技能，即可在任何地方使用——无论是通过Claude的内置支持，还是通过MCP在VS Code、Cursor和其他工具中使用。

</details> <details> <summary><strong>技能是如何工作的？</strong></summary>

技能使用三级逐步披露系统来高效管理上下文：

  1. 元数据（约100个令牌）：启动时加载名称和描述。
  2. 指令（约5千个令牌）：主要SKILL.md内容在触发技能时加载。
  3. 资源（按需加载）：参考资料、脚本和资产按需访问。

这意味着你可以安装数十种技能而不会产生上下文惩罚——代理只在需要时加载所需内容。

</details>

创建技能

<details> <summary><strong>快速入门：基本技能结构</strong></summary>

技能遵循Anthropic基于惯例的格式，源自Claude Skills：

技能名称/
├── SKILL.md              # 必需：技能元数据和指令
├── references/           # 可选：按需加载的文档
├── scripts/              # 可选：可执行代码
└── assets/               # 可选：用于输出的模板和文件

SKILL.md 格式

---
name: 技能名称
description: 这个技能做什么以及何时使用它（具体些！）
---

# 技能名称

## 指令

[代理的分步指导]

## 示例

[具体的使用示例]

编写良好技能的小贴士：

  • 描述具体何时使用该技能。
  • 使用祈使语或不定式形式在指令中（“要执行X，使用Y”）。
  • 保持SKILL.md在5千字以内；将详细的文档移到references/。
  • 包含确定性操作的脚本。
  • 在assets/中包含用于输出的模板。

更多详情，请参阅技能规范。

</details>

高级用法

<details> <summary><strong>命令行选项</strong></summary>

参数

  • -s, --skills-dir：技能目录的路径（必需，可以多次指定，必须是绝对路径）

多个技能目录

指定多个技能目录时，所有目录都会被扫描以查找技能。如果在不同目录中找到具有相同ID的多个技能，则会记录警告，并使用最后加载的技能。

带有多个目录的示例配置：

{
  "servers": {
    "skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "skills-mcp",
        "-s",
        "/路径/到/skills1",
        "-s",
        "/路径/到/skills2"
      ]
    }
  }
}

测试服务器

你可以手动使用stdio测试服务器：

npx skills-mcp --skills-dir /绝对路径/到/技能

服务器将启动并等待stdin上的JSON-RPC消息。按Ctrl+C停止服务器。

</details> <details> <summary><strong>安全注意事项</strong></summary>

⚠️ 重要：技能为代理提供了指令和可执行代码。仅使用来自可信来源的技能——你自己创建的或从Anthropic获得的。

恶意技能可以：

  • 指导代理以有害方式调用工具。
  • 执行具有代理权限的代码。
  • 访问或泄露敏感数据。

将技能视为软件安装：仅从可信来源安装，特别是在生产系统中，这些系统具有访问敏感数据或关键操作的权限。

更多详情，请参阅安全注意事项部分中的规范。

</details>

API 参考

<details> <summary><strong>可用工具</strong></summary>

list_skills

列出所有可用技能及其元数据。

输出：

{
  "skills": [
    {
      "id": "pdf-processing",
      "name": "PDF处理",
      "description": "从PDF文件中提取文本和表格..."
    }
  ]
}

get_skill

检索完整的技能内容和绝对路径。

输入：

{
  "id": "pdf-processing"
}

输出：

{
  "path": "/Users/用户名/.claude/skills/pdf-processing/SKILL.md",
  "name": "PDF处理",
  "description": "提取文本和表格...",
  "content": "# PDF处理\n\n## 快速开始\n..."
}
</details> <details> <summary><strong>可用提示</strong></summary>

init-skills

提供有关Skills MCP工作流程的信息性指导。此提示：

  • 解释什么是技能以及它们是如何构建的。
  • 描述逐步披露模型（仅在需要时加载所需内容）。
  • 描述发现、加载和使用技能的步骤。
  • 澄清MCP是一个最小包装器——代理处理所有文件操作。

何时使用：在对话开始时运行以提供背景上下文。此提示仅为信息性——不会触发任何即时动作。代理将在遇到与现有技能描述匹配的任务时使用技能。

</details> <details> <summary><strong>它是如何工作的</strong></summary>

Skills MCP遵循最小包装器设计，利用现代AI代理的全部能力：

服务器提供的内容：

  • 技能发现和元数据。
  • 带有绝对文件路径的技能内容。
  • 特定于技能的上下文格式。

代理处理的内容（使用其现有的工具）：

  • 读取引用文件（references/、scripts/、assets/）。
  • 执行脚本。
  • 搜索和导航目录。

示例工作流程：

  1. 代理调用list_skills并找到“PDF处理”。
  2. 代理调用get_skill并收到/路径/到/pdf-processing/SKILL.md。
  3. 技能提到references/FORMS.md用于高级功能。
  4. 代理构造完整路径并读取它：/路径/到/pdf-processing/references/FORMS.md。
  5. 代理执行脚本：cd /路径/到/pdf-processing && python scripts/fill_form.py。

这种设计保持了MCP服务器的简洁性，同时赋予代理最大的灵活性。

</details>

更多学习