Skillhub MCP

🚀 Skillhub MCP

Skillhub MCP は、Claude スタイルのスキルを MCP ツールに変換することで、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 スキルではない
• チームが複数のエージェント (Cursor、Copilot、Codex など) を使用しているため、ツール間でのスキルの再利用が困難
• スキルをより柔軟に組織し、配布する方法が必要 (ネストされたフォルダ、zip パッケージング)

⚠️ 実験的なものです。スキルにはスクリプトやリソースが含まれる場合があります。信頼できないものとして扱い、可能な場合はサンドボックスやコンテナで実行してください。

これは MCP サーバーですか、それとも MCP クライアントですか？

このプロジェクトは MCP サーバー です。

• Skillhub MCP (このリポジトリ): サーバープロセスとして実行され、ツールやリソースをクライアントに公開します。
• MCP クライアント: Cursor、Claude Code、Codex などのエディタやエージェントです。これらは MCP サーバーを起動または接続します。

✨ 主な機能

• クロスクライアントでの再利用: 一度インストールすれば、任意の 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"]
  }
}

📦 インストール

以下は、主流の「バイブコーディング」エディタ (MCP クライアント) への最小限の動作例です。

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 はフラットなスキルディレクトリ (各直下のサブディレクトリが 1 つのスキル) を期待します。Skillhub MCP はより柔軟で、以下をサポートします。

• ネストされたディレクトリの検出
• .zip / .skill でパッケージ化されたスキルのサポート

Claude Code との互換性が必要な場合は、フラットなレイアウトを維持してください。

📄 CLI リファレンス

skillhub-mcp [skills_root] [options]

⚠️ 安全上の注意

• スキルは「単なるプロンプト」ではなく、スクリプトや任意のファイルを含む場合があります。
• Skillhub MCP はスクリプトを実行しませんが、クライアントが実行する可能性があります。サンドボックスやコンテナで実行することを推奨します。

🌐 言語

• 英語: README.md
• 中国語: README.zh-CN.md

👨‍💻 作者について

私は AI SaaS のグローバル展開 に焦点を当てており、アイデアの検証とバイブコーディング から 製品開発、インフラストラクチャ、SEO、バックリンク、および成長実験 までの全行程をカバーしています。

ここで共有するすべての内容は、実際のプロジェクト、実際のトラフィック、および実際の収益獲得の試みに基づいています。

• Feishu 知識ベース: Thor’s AI Going-Global Content Planning AI 製品の海外展開における実践的な経験を文書化した構造化された知識ベースで、需要発見、実行戦略、および一般的な落とし穴が含まれています。

• ブログ: Thor-AI Blog AI 製品の構築、立ち上げ、および反復に関する長文のメモとケーススタディを公開しています。

• オープンソースプロジェクト (高スター数): スマートキャンパスシステム

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

• ソーシャル: Jike インディーハッキング、AI ツール、および製品の成長に関するリアルタイムの考えを共有しています。

• 製品:

  • AI ビデオ生成プラットフォーム: Sora 2 Sora 2 ai 実用的なユースケースと実際のユーザーワークフローに焦点を当てた、AI ベースのビデオ生成のオンラインプラットフォーム。

  • AI ビデオと画像生成: AI Video & Image Collection Model pages:

    • 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