项目简介

Skills MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端服务,旨在将 Anthropic Claude 的 Skills 概念引入到任何兼容 MCP 的AI代理中。它允许LLM代理通过统一的方式发现、加载和使用由 'SKILL.md' 文件定义的技能,从而扩展其知识和功能。

主要功能点

  • 技能托管与发现:扫描指定目录,自动发现并注册所有符合规范的技能。
  • 技能信息提供:提供工具供LLM客户端查询可用技能的元数据(ID、名称、描述)。
  • 技能内容访问:根据技能ID提供完整的技能内容(SKILL.md),包括操作指南和资源路径。
  • 渐进式加载:技能信息按需加载,LLM代理仅在需要时获取详细内容,优化上下文使用。
  • 标准化Prompt:提供 '/init-skills' Prompt,为LLM代理提供技能MCP的工作流程指导。
  • 多目录支持:可以配置多个技能目录,方便管理不同来源的技能。

安装步骤

  1. 确保Node.js环境:你的系统需要安装 Node.js。
  2. 安装 Skills MCP:你可以通过 'npx' 直接运行,无需全局安装。在你的项目或全局配置中引用时,'npx' 会自动下载并运行。
  3. 准备技能目录:创建一个目录,并在其中放置你的技能。每个技能是一个子目录,包含一个 'SKILL.md' 文件,例如:
    my-skills/
    ├── pdf-processing/
    │   └── SKILL.md
    └── data-analysis/
        └── SKILL.md
    你也可以通过 'npx degit anthropics/skills/skill-creator skills/skill-creator' 命令获取 Anthropic 提供的示例技能。

服务器配置

MCP服务器是给MCP客户端(如Claude Code, Cursor, VS Code等)使用的。你需要将 Skills MCP 服务器的启动命令及其参数配置到你的MCP客户端中。以下是一些常见客户端的配置示例。请将 '/absolute/path/to/your/skills' 替换为你的实际技能目录的绝对路径。

  • Claude Code ('.mcp.json' 或 '~/.claude.json'):

    {
      "mcpServers": {
        "skills-mcp": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/your/skills"]
        }
      }
    }
    • 'skills-mcp': 服务器的唯一名称。
    • 'type': 通信协议类型,这里是标准输入输出(stdio)。
    • 'command': 启动服务器的命令,这里是 'npx',它会执行指定包的二进制文件。
    • 'args': 传递给命令的参数。'-y' 允许 'npx' 自动安装包,'skills-mcp' 是要运行的包名,'-s' 或 '--skills-dir' 用于指定技能目录的绝对路径。
  • Cursor ('.cursor/mcp.json' 或 '~/.cursor/mcp.json'):

    {
      "mcpServers": {
        "skills-mcp": {
          "command": "npx",
          "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/your/skills"]
        }
      }
    }
    • 配置项与 Claude Code 类似,'type' 可能会根据客户端默认行为自动推断为 'stdio'。
  • VS Code ('.vscode/mcp.json'):

    {
      "servers": {
        "skills-mcp": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/your/skills"]
        }
      }
    }
    • 配置项与 Claude Code 类似,但顶级键名为 'servers'。

基本使用方法

配置完成后,当你的AI代理与 Skills MCP 服务器连接时,它将能够:

  1. 发现技能:代理可以调用 'list_skills' 工具来获取所有可用技能的列表及其描述。
  2. 获取技能内容:当代理识别出某个任务需要特定技能时,它可以调用 'get_skill' 工具,提供技能ID,从而获取该技能的完整 'SKILL.md' 内容和其在文件系统中的绝对路径。
  3. 遵循技能指南:代理会阅读 'SKILL.md' 中的指令,并根据指令通过其自身的文件读取或脚本执行工具来访问技能目录下的 'references/'、'scripts/' 或 'assets/' 等资源。
  4. 初始化会话:推荐在每个会话开始时运行 '/init-skills' Prompt,向代理提供关于 Skills MCP 工作流程的背景指导。

信息

分类

AI与计算