Claude Skills MCP

🚀 Claude Skills MCP Server

藉助該MCP服務器，通過模型上下文協議（MCP）將Anthropic的代理技能框架引入整個AI生態系統，讓任何AI模型或編碼助手都能使用Claude強大的新技能系統。

Claude Skills MCP Server是一個模型上下文協議（MCP）服務器，它利用向量嵌入和語義相似度，為發現相關的Claude代理技能提供智能搜索功能。該服務器實現了Anthropic在其代理技能工程博客中描述的漸進式披露架構，使任何兼容MCP的AI應用都能使用專業技能。

這是一個由K-Dense AI發起的開源項目 —— K-Dense AI是為科學研究創建自主AI科學家的團隊。

此MCP服務器使任何兼容MCP的AI助手都能從我們精心策劃的Claude科學技能倉庫以及其他技能源（如官方Claude技能）中智能搜索和檢索技能。

🚀 快速開始

針對Cursor用戶

可以通過Cursor目錄添加，或者將其添加到你的Cursor配置文件（~/.cursor/mcp.json）中：

{
  "mcpServers": {
    "claude-skills": {
      "command": "uvx",
      "args": ["claude-skills-mcp"]
    }
  }
}

前端會立即啟動並顯示工具，同時在後臺自動下載並啟動後端（由於RAG依賴，首次啟動約需60 - 120秒，僅首次需要）。後續使用將立即響應。

使用uvx（獨立運行）

使用默認配置運行服務器：

uvx claude-skills-mcp

這將啟動輕量級前端，它會自動下載後端，並從Anthropic的官方技能倉庫和K-Dense AI的科學技能集合中加載約90個技能。

使用自定義配置

# 1. 打印默認配置
uvx claude-skills-mcp --example-config > config.json

# 2. 根據需要編輯config.json

# 3. 使用自定義配置運行
uvx claude-skills-mcp --config config.json

✨ 主要特性

• 雙包架構：輕量級前端（約15 MB）可立即啟動；後端（約250 MB）在後臺下載。
• 無Cursor超時問題：前端響應時間小於5秒，解決了超時問題。
• 語義搜索：利用向量嵌入實現智能技能發現。
• 漸進式披露：多級技能加載（元數據 → 完整內容 → 文件）。
• 零配置：使用精心策劃的技能，開箱即用。
• 多源加載：可從GitHub倉庫和本地目錄加載技能。
• 快速本地運行：無需API密鑰，支持自動GitHub緩存。
• 可配置：可自定義技能源、模型和內容限制。

💻 使用示例

基礎用法

在Cursor中使用時，通過上述快速開始的配置添加該MCP服務器後，即可使用服務器提供的工具進行Claude代理技能的操作。例如，使用find_helpful_skills工具進行語義搜索：

# 假設在支持的環境中調用該工具
# 這裡只是示例，實際代碼需根據具體環境實現
result = find_helpful_skills(task_description="需要一個數據分析的技能")

高級用法

在自定義配置中，可以根據實際需求調整技能源和其他參數。例如，在config.json中添加自定義的技能源：

{
  "skill_sources": [
    "https://github.com/my-custom-skills-repo",
    "~/local-skills-directory"
  ]
}

然後使用自定義配置啟動服務器：

uvx claude-skills-mcp --config config.json

📚 詳細文檔

• 入門指南 —— 安裝、Cursor設置、CLI使用和故障排除。
• 架構指南 —— 雙包設計、數據流和組件。
• API文檔 —— 工具參數、示例和最佳實踐。
• 使用示例 —— 高級配置、實際用例和自定義技能創建。
• 測試指南 —— 完整的測試說明、CI/CD和覆蓋率分析。

🔧 技術細節

MCP工具

該服務器提供了三個用於處理Claude代理技能的工具：

1. find_helpful_skills —— 根據任務描述進行語義搜索，查找相關技能。
2. read_skill_document —— 從技能中檢索特定文件（腳本、數據、參考資料）。
3. list_skills —— 查看所有已加載技能的完整清單（用於探索/調試）。 具體參數、示例和最佳實踐請參考API文檔。

架構（v1.0.0）

系統採用雙包架構以實現最佳性能：

• 前端 (claude-skills-mcp)：輕量級代理（約15 MB）

  • 可立即啟動（<5秒）✅ 無Cursor超時問題！
  • 首次使用時自動下載後端。
  • 作為Cursor的MCP服務器（標準輸入輸出）。

• 後端 (claude-skills-mcp-backend)：重型服務器（約250 MB）

  • 使用PyTorch和sentence-transformers進行向量搜索。
  • 作為MCP服務器（可流式HTTP）。
  • 由前端自動安裝或可獨立部署。

優點：

• ✅ 解決了Cursor超時問題（前端立即啟動）。
• ✅ 提供相同的簡單用戶體驗（uvx claude-skills-mcp）。
• ✅ 後端在後臺下載（不阻塞Cursor）。
• ✅ 可連接到遠程託管的後端（無需本地安裝）。 詳細設計和數據流請參考架構指南。

技能源

可以從GitHub倉庫（直接的技能或Claude代碼插件）或本地目錄加載技能。 默認情況下，從以下位置加載：

• 官方Anthropic技能 —— 15種不同的技能，適用於文檔、演示文稿、網頁製品等。
• K-Dense AI科學技能 —— 78 + 種專業技能，適用於生物信息學、化學信息學和科學分析。
• 本地目錄~/.claude/skills（如果存在）。

🤝 貢獻代碼

歡迎貢獻代碼！若要貢獻，請遵循以下步驟：

1. 報告問題：提交一個問題，反饋錯誤或提出功能請求。
2. 提交PR：分叉倉庫，創建功能分支，確保測試通過（uv run pytest tests/），然後提交。
3. 代碼風格：提交前運行uvx ruff check src/。
4. 添加測試：新功能應包含測試。

開發說明

版本管理：此單倉庫使用集中式版本系統：

• 編輯倉庫根目錄下的VERSION文件以更新版本。
• 運行python3 scripts/sync-version.py同步所有引用（或使用--check進行驗證）。
• scripts/build-all.sh腳本在構建前會自動同步版本。

如有疑問，請發送郵件至 orion.li@k-dense.ai。

🚀 加入我們的社區！

我們非常歡迎你加入我們的Slack社區！ 在這裡，你可以與其他用戶交流，分享技巧和竅門，獲取技能使用幫助，並第一時間瞭解新功能和更新。

👉 加入K-Dense社區Slack 👈

無論你是在構建自定義技能、與不同的AI模型集成，還是僅僅探索代理技能的可能性，我們的社區都會為你提供支持！

📖 瞭解更多

• 代理技能文檔 —— Anthropic官方關於技能格式的文檔。
• 代理技能博客文章 —— 技能系統的發佈公告和概述。
• 模型上下文協議 —— 使跨平臺技能成為可能的協議。
• 工程博客：為現實世界裝備代理 —— 關於技能架構的技術深度剖析。

📄 許可證

本項目採用Apache許可證2.0授權。

版權所有 2025 K-Dense AI (https://k-dense.ai)

⭐ 星標歷史