Skillhub MCP

🚀 Skillhub MCP

Skillhub MCP 能夠將 Claude 風格的技能轉化為 MCP 工具，使得任何 MCP 客戶端都可以調用相同的技能，解決了客戶端語言不匹配以及技能跨工具複用困難等問題。

📎 鏈接

• PyPI: https://pypi.org/project/skillhub-mcp/
• PyPI v1.0.1: https://pypi.org/project/skillhub-mcp/1.0.1/
• 技能目錄: http://skills.214140846.net/

mcp-name: io.github.214140846/skillhub-mcp

你可能已經擁有 Claude 風格的技能（SKILL.md），但在實際應用中常常會遇到一些問題：

• 你的客戶端使用的是 MCP，而不是 Claude Skills。
• 你的團隊使用多種代理（如 Cursor、Copilot、Codex 等），因此技能在不同工具之間的複用很麻煩。
• 你希望有一種更靈活的方式來組織和分發技能（如嵌套文件夾、zip 打包）。

⚠️ 重要提示

此項目處於實驗階段。技能可能包含腳本和資源，請將其視為不可信內容，並儘可能在沙箱或容器中運行。

✨ 主要特性

• 跨客戶端複用：只需安裝一次，即可在任何 MCP 客戶端中使用。
• 靈活的打包方式：支持嵌套目錄、.zip 和 .skill 存檔。
• 技能資源：將腳本、數據集和示例作為 MCP 資源（客戶端可以讀取的文件）公開。
• 資源回退機制：為不支持原生 MCP 資源的客戶端提供 fetch_resource 工具。
• 多種傳輸方式：支持 stdio（默認）、http 和 sse。

🚀 快速開始

默認的技能根目錄為：~/.skillhub-mcp

uvx（推薦）

{
  "skillhub-mcp": {
    "command": "uvx",
    "args": ["skillhub-mcp@latest"]
  }
}

使用自定義技能根目錄：

{
  "skillhub-mcp": {
    "command": "uvx",
    "args": ["skillhub-mcp@latest", "/path/to/skills"]
  }
}

📦 安裝指南

以下是主流 “氛圍編碼” 編輯器的最小工作示例。

Cursor

Cursor 支持通過 mcp.json 配置 MCP 服務器。將以下內容添加到全局 ~/.cursor/mcp.json 或項目 .cursor/mcp.json 中，然後重啟 Cursor。

{
  "mcpServers": {
    "skillhub-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["skillhub-mcp@latest", "/path/to/skills"]
    }
  }
}

Claude Code

選項 A：通過 Claude Code CLI 進行配置（推薦用於快速設置）：

claude mcp add --transport stdio skillhub-mcp -- uvx skillhub-mcp@latest /path/to/skills

選項 B：通過項目根目錄下的 .mcp.json 進行項目範圍的配置。你可能需要在 .claude/settings.json 中明確允許項目 MCP 服務器。

./.mcp.json

{
  "mcpServers": {
    "skillhub-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["skillhub-mcp@latest", "/path/to/skills"]
    }
  }
}

./.claude/settings.json（僅批准此服務器）

{
  "enabledMcpjsonServers": ["skillhub-mcp"]
}

Codex (OpenAI)

選項 A：使用 Codex CLI 添加一個 stdio MCP 服務器：

codex mcp add skillhub-mcp -- uvx skillhub-mcp@latest /path/to/skills

選項 B：編輯 ~/.codex/config.toml：

[mcp_servers.skillhub-mcp]
command = "uvx"
args = ["skillhub-mcp@latest", "/path/to/skills"]

💻 使用示例

基礎用法

Skillhub MCP 會在根目錄（默認 ~/.skillhub-mcp）下發現技能。每個技能可以是：

• 包含 SKILL.md 的目錄。
• 包含 SKILL.md 的 .zip 或 .skill 存檔（存檔根目錄或單個頂級文件夾內）。

所有其他文件將成為可供代理讀取的可下載 MCP 資源。注意：Skillhub MCP 不會執行腳本，客戶端決定是否以及如何運行它們。

示例佈局：

~/.skillhub-mcp/
├── summarize-docs/
│   ├── SKILL.md
│   ├── summarize.py
│   └── prompts/example.txt
├── translate.zip
├── analyzer.skill
└── web-search/
    └── SKILL.md

存檔規則：

translate.zip
├── SKILL.md
└── helpers/
    └── translate.js

data-cleaner.zip
└── data-cleaner/
    ├── SKILL.md
    └── clean.py

📚 詳細文檔

目錄結構：Skillhub MCP 與 Claude Code 的對比

Claude Code 期望一個扁平的技能目錄（每個直接子目錄都是一個技能）。而 Skillhub MCP 更加寬鬆：

• 支持嵌套目錄。
• 支持 .zip / .skill 打包的技能。

如果你需要與 Claude Code 兼容，請保持扁平佈局。

CLI 參考

skillhub-mcp [skills_root] [options]

安全注意事項

• 技能不僅僅是提示：它們可以包含腳本和任意文件。
• Skillhub MCP 不會運行腳本，但你的客戶端可能會。建議在沙箱或容器中運行。

語言支持

• 英文: README.md
• 中文: README.zh-CN.md

👨‍💻 關於作者

作者專注於 AI SaaS 全球化，涵蓋了從 創意驗證和氛圍編碼 到 產品開發、基礎設施、SEO、反向鏈接和增長實驗 的整個過程。

這裡分享的所有內容都來自真實的項目、真實的流量和真實的營收嘗試。

• 飛書知識庫： Thor 的 AI 全球化內容規劃 這是一個結構化的知識庫，記錄了 AI 產品海外拓展的實踐經驗，包括需求發現、執行策略和常見陷阱。

• 博客： Thor-AI 博客 公開分享關於構建、發佈和迭代 AI 產品的長篇筆記和案例研究。

• 開源項目（高星）： 智慧校園系統

  • GitHub: https://github.com/214140846/TOGO_School_Miniprograme
  • Gitee: https://gitee.com/zengyunengineer/TOGO_School_Miniprograme

• 社交平臺： 即刻 分享關於獨立開發、AI 工具和產品增長的即時想法。

• 產品：

  • AI 視頻生成平臺： Sora 2 Sora 2 ai 一個基於 AI 的在線視頻生成平臺，專注於實際用例和真實用戶工作流程。

  • AI 視頻與圖像生成： AI 視頻與圖像集合

    模型頁面：

    • Grok Video
    • Sora 2
    • Veo 3.1
    • Veo 3
    • Veo 2
    • Kling 2.6
    • Wan 2.5
    • Seedance
    • Nano Banana 2
    • Nano Banana Pro

    這是一個精心策劃的 AI 視頻和圖像生成工具集合，包含實驗和能力跟蹤。

• AI 視頻與圖像集合： https://www.notion.so/2e7600937cb3808c818efe79141f7ee6