项目简介

Claude Skills MCP 服务器是一个强大的后端服务,旨在通过Model Context Protocol (MCP) 将Anthropic的Agent技能框架开放给整个AI生态系统。它允许Cursor、Codex、GPT-5、Gemini等任何兼容MCP的AI应用智能地搜索、发现并使用Claude Agent技能,从而扩展这些AI模型的能力范围。

该服务器采用独特的两包架构:一个轻量级前端('claude-skills-mcp')作为即时启动的代理,一个包含向量搜索和技能管理功能的重型后端('claude-skills-mcp-backend')在后台运行,确保了极佳的用户体验和性能。

主要功能点

  • 智能技能搜索: 利用向量嵌入和语义相似性技术,根据任务描述智能推荐最相关的Claude Agent技能。
  • 渐进式技能披露: 支持多级技能加载,从元数据到完整内容,再到辅助文件,按需获取,提升效率。
  • 多来源技能加载: 可从Anthropic官方技能库、K-Dense AI科学技能库、GitHub仓库以及本地目录加载技能。
  • 技能文档访问: 允许按需获取技能相关的脚本、参考资料、资产等文件内容,支持模糊匹配。
  • 零配置与本地运行: 大部分功能开箱即用,无需API密钥,自动缓存GitHub资源,支持本地快速运行。
  • 后台自动更新: 支持配置自动检测并更新GitHub和本地技能源的变化。

安装步骤

该服务器通过 'uvx' 工具安装和运行,'uvx' 会自动管理Python环境和依赖。

  1. 安装 'uv': 如果尚未安装 'uv',请先运行以下命令(任选其一):
    • 通过 'curl' (推荐): 'curl -LsSf https://astral.sh/uv/install.sh | sh'
    • 通过 'pip': 'pip install uv'
  2. 运行服务器: 使用以下命令启动MCP服务器。前端将立即启动,并在后台自动下载并启动后端服务(首次启动可能需要等待约60-120秒以下载依赖和加载技能,后续启动将非常迅速)。 'uvx claude-skills-mcp'

服务器配置

MCP客户端(如Cursor)连接到此服务器时,需要配置服务器的启动命令。以下是标准的MCP客户端配置JSON片段,您需要将其添加到您的MCP客户端配置文件(例如'~/.cursor/mcp.json')中:

{
  "mcpServers": {
    "claude-skills": {
      "command": "uvx",
      "args": ["claude-skills-mcp"],
      "comment": "通过uvx命令启动Claude Skills MCP服务器,它会管理后端服务的下载与运行。"
    }
  }
}

如果您需要使用自定义配置(例如更改技能来源、嵌入模型、API Token等),可以先生成一个示例配置模板,然后根据需要修改,并在启动命令中指定该配置文件:

  1. 生成示例配置: 'uvx claude-skills-mcp-backend --example-config > config.json'
  2. 编辑 'config.json' 文件,根据您的需求修改参数。
  3. 使用自定义配置启动服务器: 将MCP客户端配置修改为:
    {
      "mcpServers": {
        "claude-skills": {
          "command": "uvx",
          "args": ["claude-skills-mcp", "--config", "/path/to/your/config.json"],
          "comment": "指定自定义配置文件启动Claude Skills MCP服务器。请替换 /path/to/your/config.json 为实际路径。"
        }
      }
    }
    或者在独立模式下: 'uvx claude-skills-mcp --config config.json'

基本使用方法

一旦服务器启动并连接到您的MCP客户端(如Cursor),您就可以通过调用其提供的工具来与Claude Agent技能进行交互:

  • 'find_helpful_skills': 这是您开始时的首选工具。提供任务描述,服务器将返回最相关的技能及其详细信息。 示例: 'find_helpful_skills(task_description="我需要分析基因表达数据", top_k=5)'
  • 'read_skill_document': 在找到相关技能后,使用此工具获取技能的特定文件(例如Python脚本、配置文件)。 示例: 'read_skill_document(skill_name="Bioinformatics Analysis", document_path="scripts/*.py")'
  • 'list_skills': 查看所有已加载技能的完整清单,适用于探索或调试。 示例: 'list_skills()' 这些工具将使您的AI助手能够利用Claude Agent技能完成更复杂的、领域特定的任务。

信息

分类

AI与计算