mcphub

MCPHub: モデルコンテキストプロトコル (MCP) サーバーの統合ハブ

MCPHub を使用すると、複数の MCP (Model Context Protocol) サーバーを柔軟な Streamable HTTP (SSE) エンドポイントに編成して、すべてのサーバー、個々のサーバー、または論理サーバーグループへのアクセスをサポートすることで、それらの管理と拡張が容易になります。

ダッシュボードプレビュー

🚀 機能

拡張された MCP サーバーサポート: 最小限の構成であらゆる MCP サーバーをシームレスに統合します。
集中ダッシュボード: 1 つの洗練された Web UI からリアルタイムのステータスとパフォーマンスメトリックを監視します。
柔軟なプロトコル処理: stdio および SSE MCP プロトコルの両方と完全に互換性があります。
ホットスワップ可能な構成: MCP サーバーをオンザフライで追加、削除、または更新できるため、ダウンタイムは必要ありません。
グループベースのアクセス制御: カスタマイズ可能なグループにサーバーを編成し、権限管理を効率化します。
安全な認証: JWT と bcrypt を活用したロールベースのアクセスを備えた組み込みのユーザー管理。
Docker 対応: コンテナ化されたセットアップで即座にデプロイできます。

🔧 クイックスタート

オプション構成

サーバー設定をカスタマイズするには、 mcp_settings.jsonファイルを作成します。

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-bot-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    }
  }
}

Docker デプロイメント

推奨: カスタム設定をマウントします:

docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub

またはデフォルト設定で実行します。

docker run -p 3000:3000 samanhappy/mcphub

ダッシュボードにアクセスする

http://localhost:3000を開き、資格情報を使用してログインします。

注: デフォルトの資格情報はadmin / admin123です。

ダッシュボードの概要:

すべてのMCPサーバーのライブステータス
サーバーの有効化/無効化または再構成
サーバーを整理するためのグループ管理
アクセス制御のためのユーザー管理

ストリーミング可能なHTTPエンドポイント

現時点では、ストリーミングHTTPエンドポイントのサポートはAIクライアントによって異なります。問題が発生した場合は、SSEエンドポイントをご利用いただくか、今後のアップデートをお待ちください。

次の方法で AI クライアント (Claude Desktop、Cursor、DeepChat など) を接続します。

http://localhost:3000/mcp

このエンドポイントは、すべてのMCPサーバーに統合されたストリーミング可能なHTTPインターフェースを提供します。これにより、以下のことが可能になります。

設定されたMCPサーバーにリクエストを送信する
リアルタイムで回答を受け取る
さまざまなAIクライアントやツールと簡単に統合できます
すべてのサーバーに同じエンドポイントを使用することで、統合プロセスが簡素化されます。

グループ固有のエンドポイント（推奨） :

グループマネジメント

特定のサーバーグループへのターゲットアクセスの場合は、グループベースの HTTP エンドポイントを使用します。

http://localhost:3000/mcp/{group}

{group}ダッシュボードで作成したグループのIDまたは名前です。これにより、以下のことが可能になります。

ユースケース別に整理された MCP サーバーの特定のサブセットに接続します
関連するサーバーのみにアクセスするために、さまざまな AI ツールを分離する
さまざまな環境やチームに対してよりきめ細かなアクセス制御を実装する

サーバー固有のエンドポイント: 個々のサーバーに直接アクセスするには、サーバー固有の HTTP エンドポイントを使用します。

http://localhost:3000/mcp/{server}

{server}は接続先のサーバー名です。これにより、特定の MCP サーバーに直接アクセスできます。

注意：サーバー名とグループ名が同じ場合は、グループ名が優先されます。

SSE エンドポイント (将来廃止予定)

次の方法で AI クライアント (Claude Desktop、Cursor、DeepChat など) を接続します。

http://localhost:3000/sse

特定のサーバーグループへのターゲットアクセスの場合は、グループベースの SSE エンドポイントを使用します。

http://localhost:3000/sse/{group}

個々のサーバーに直接アクセスするには、サーバー固有の SSE エンドポイントを使用します。

http://localhost:3000/sse/{server}

🧑‍💻 地域開発

git clone https://github.com/samanhappy/mcphub.git
cd mcphub
pnpm install
pnpm dev

これにより、フロントエンドとバックエンドの両方がホットリロードを使用して開発モードで起動されます。

Windows ユーザーの場合、バックエンドサーバーとフロントエンドを別々に起動する必要がある場合があります: pnpm backend:dev 、 pnpm frontend:dev 。

🛠️ よくある問題

Nginxをリバースプロキシとして使用する

Nginx を使用して MCPHub をリバースプロキシする場合は、Nginx セットアップに次の構成を追加してください。

proxy_buffering off

🔍 技術スタック

バックエンド: Node.js、Express、TypeScript
フロントエンド: React、Vite、Tailwind CSS
認証: JWT & bcrypt
プロトコル: モデルコンテキストプロトコルSDK

👥 貢献する

あらゆる種類の貢献を歓迎します!

新機能と最適化
ドキュメントの改善
バグ報告と修正
翻訳と提案

ディスカッションやサポートのために、 Discord コミュニティにぜひご参加ください。

❤️ スポンサー

このプロジェクトが気に入ったら、次のことも検討してみてください:

🌟 スターの歴史

📄 ライセンス

Apache 2.0 ライセンスに基づいてライセンスされます。