Central MCP Proxy

🚀 中央 MCP サーバーホスト

このプロジェクトは、Docker、Traefik、SuperGateway を使用して、Model Context Protocol (MCP) サーバーを実行するための集中管理環境を提供します。

🚀 クイックスタート

このプロジェクトは、Traefik を用いたリバースプロキシにより、様々な MCP サーバーへのリクエストをルーティングします。また、SuperGateway を使用して、stdio と SSE トランスポート間の変換を行い、MCP サーバーが SSE を通じてクライアントと通信できるようにしています。

✨ 主な機能

• Notion：Notion のデータベースやページとのやり取りが可能です。
• Linear：Linear のチケットとのやり取りができます。
• GitHub：GitHub のリポジトリ、イシュー、プルリクエストとのやり取りが可能です。
• Memory Bank：プロジェクトのノート、思考の軌跡、学習内容を記録するツールです。

📦 インストール

前提条件

• Docker と Docker Compose
• Notion API トークン
• Linear API トークン
• GitHub API トークン

セットアップ手順

1. このリポジトリをクローンします。
2. .env.example ファイルを .env にコピーし、API トークンを記入します。

   cp .env.example .env
   # .env ファイルを編集し、API トークンを入力します
   

3. サービスを起動します。

   docker compose up -d
   

Docker Compose 構造

このプロジェクトは、モジュール化された Docker Compose 構造を使用しています。

• docker-compose.yml：Traefik の設定を含む主要なファイルで、サービス固有のファイルを参照します。
• docker-compose/github.yml：GitHub MCP サーバーの設定。
• docker-compose/notion.yml：Notion MCP サーバーの設定。
• docker-compose/memory-bank.yml：Memory Bank MCP サーバーの設定。
• docker-compose/linear.yml：Linear MCP サーバーの設定。

このモジュール化された方法により、以下のことが可能です。

• すべてのサービスを起動する：docker compose up -d（デフォルトの all 設定ファイルを使用）
• 設定ファイルを使用して特定のサービスを起動する：
  • GitHub のみ：docker compose --profile github up -d
  • Notion のみ：docker compose --profile notion up -d
  • Memory Bank のみ：docker compose --profile memory-bank up -d
  • Linear のみ：docker compose --profile linear up -d
  • すべてのサービスを明示的に起動する：docker compose --profile all up -d
• docker-compose フォルダに新しいファイルを作成することで、新しいサービスを簡単に追加できます。

⚠️ 重要提示

• このプロジェクトは、最新の Docker Compose の実践に則っており、version キーワードを省略することで（Docker Compose V2 以降では不要）、现代化を実現しています。
• ネットワーク設定は、主要な docker-compose.yml ファイルにのみ定義されており、衝突を避けるためにすべてのサービスがこのネットワークを参照しますが、再定義しません。
• デフォルトの設定ファイルは、.env ファイルで COMPOSE_PROFILES 環境変数を使用して all に設定されており、設定ファイルを明示的に指定せずに docker compose up を実行できます。

💻 使用例

基本的な使用法

サービスが起動したら、各ツールの対応するパスルートを通じてサービスにアクセスできます。

パスベースのルーティング

• Traefik ダッシュボード：http://$HOSTNAME/dashboard/
• Notion MCP サーバー：
  • SSE エンドポイント：http://$HOSTNAME/notion/sse
  • メッセージエンドポイント：http://$HOSTNAME/notion/message
• GitHub MCP サーバー：
  • SSE エンドポイント：http://$HOSTNAME/github/sse
  • メッセージエンドポイント：http://$HOSTNAME/github/message
• Linear MCP サーバー：
  • SSE エンドポイント：http://$HOSTNAME/linear/sse
  • メッセージエンドポイント：http://$HOSTNAME/linear/message
• Memory-bank MCP サーバー：
  • SSE エンドポイント：http://$HOSTNAME/memory-bank/sse
  • メッセージエンドポイント：http://$HOSTNAME/memory-bank/message

🔧 技術詳細

SuperGateway

SuperGateway は、stdio と SSE トランスポート間の変換に使用されます。

1. SuperGateway はコンテナ内にインストールされます。
2. MCP サーバーコマンドを実行し、--stdio フラグを使用します。
3. SSE 接続とメッセージ送信のための HTTP エンドポイントを公開します。

Traefik 設定

Traefik は以下のように設定されています。

1. パスプレフィックスに基づいてリクエストをルーティングします（例：/notion、/github）。
2. トラフィックを正しいサービスにリバースプロキシします。
3. HTTPS を使用して安全な通信チャネルを提供します。

📚 ドキュメント

• プロジェクトのURL：https://github.com/nat-n/MCP-Server-Hub
• 問題の報告：このリポジトリで問題や機能要求を提出してください。
• 貢献ガイドライン：このプロジェクトに貢献する方法については、プロジェクトの README を参照してください。