MCP Gateway

Model Context Protocol サーバー向けのセルフホスト型コントロールプレーン。使用するすべての MCP サーバーを 1 箇所で定義し、Web GUI から管理し、エージェントに単一のエンドポイント（サーバーごと、または名前空間化されたツールを持つサーバーのグループ全体）を提供します。

 Claude Code · Claude Desktop · Cursor · VS Code · your agent
        │  Streamable HTTP  /mcp/servers/<id>   /mcp/groups/<id>      (+ API key)
        ▼
 ┌────────────────────── MCP Gateway ──────────────────────┐
 │  web GUI  ·  admin REST API  ·  sessions  ·  logs        │
 │  groups: namespaced tools  pg-analytics__execute_sql …   │
 │  upstream manager: start/stop, restart w/ backoff,       │
 │  health checks, idle stop, tool filters & renames        │
 └───────┬──────────────────┬──────────────────┬───────────┘
   stdio (npx/uvx/docker)   Streamable HTTP     legacy SSE
   Postgres, filesystem…    remote MCP servers  older servers

シナリオ。 エージェントが 2 つの Postgres データベースを必要としています。GUI で pg-analytics と pg-orders を追加し（PostgreSQL (DBHub) テンプレートから）、それらをグループ databases に入れ、エージェントを http://gateway:8808/mcp/groups/databases に向けます。エージェントには pg-analytics__execute_sql と pg-orders__execute_sql が見えます。ゲートウェイがプロセス、資格情報、再起動、ログを管理します。完全で実行可能なバージョンは examples/postgres-scenario にあります。

機能

• 任意のアップストリームトランスポート — stdio プロセス（npx、uvx、docker run、その他）、Streamable HTTP、および bearer/basic/header 認証付きのレガシー SSE リモート。

• ライフサイクル管理 — 自動/遅延起動、アイドル停止、指数バックオフと上限付き再起動、ヘルスチェック ping、起動/リクエスト/ツール呼び出しのタイムアウト、キャプチャされた stderr。

• グループ — 1 つのエンドポイントの背後に複数のサーバー。ツールとプロンプトは名前空間化され（prefix__tool、. または -）、競合処理付きパススルーも可能。メンバーごとのフィルター、統合された指示、暗黙の all グループ。

• ツールポリシー — サーバーごとの include/exclude glob、非表示、リネーム、説明の書き換え。

• 完全な MCP プロキシ — ツール、リソース（+テンプレート、サブスクリプション）、プロンプト、補完、ロギング、進捗、キャンセル、list_changed の伝播、およびサーバー→クライアントの sampling / elicitation / roots を発信元セッションへルーティング。

• ダウンストリームトランスポート — Streamable HTTP（再開可能なストリームを備えたステートフル、またはステートレス）、レガシー SSE、さらに Claude Desktop などのクライアント向けの stdio ブリッジである mcp-gateway-connect。

• セキュリティ — API キー（ハッシュ化、サーバー/グループにスコープ、期限付き）、GUI/API 用の管理トークン、シークレットの秘匿化（redaction）、${ENV} 補間（シークレットを設定ファイルに書かずに済む）、DNS リバインディング保護、CORS 許可リスト。

• GUI — ダッシュボード、16 テンプレートのサーバーカタログ（Postgres ×3、MySQL、SQLite、filesystem、GitHub、Playwright、Context7、fetch、memory、…）、Test connection 付きタブ式エディタ、Try it 付きツールエクスプローラ、リソース/プロンプトブラウザ、ライブログ、メトリクス、クライアント別接続スニペット、セッション、設定、インポート/エクスポート（Claude Desktop / Cursor / VS Code の mcpServers ファイル）。

Related MCP server: Master MCP Server

スクリーンショット

ダッシュボード — 実行中のサーバー、グループ、アクティブなセッション、ライブイベントフィード：

サーバーカタログ — トランスポート、ステータス、ツール数、再起動回数をひと目で確認：

サーバーの詳細ビュー — ランタイムとエンドポイントの情報に加え、GUI から直接ツールを呼び出せるツールエクスプローラ：

クイックスタート

必要環境：Node.js ≥ 20（実行するアップストリームサーバーに応じて npx / uvx / docker も必要）。

git clone <this repo> mcp-gateway && cd mcp-gateway
npm install
npm run build
npm start                     # → http://127.0.0.1:8808

その後、GUI で：Servers → Add server → PostgreSQL (DBHub) → DSN を貼り付け → Test connection → Create server。サーバーの Connect タブを開き、クライアント用のスニペットをコピーします。例：

claude mcp add --transport http pg-analytics http://127.0.0.1:8808/mcp/servers/pg-analytics

開発モード（Vite のホットリロードが :5173、ゲートウェイが :8808）：npm run dev。

Docker

docker compose up -d --build              # GUI on http://localhost:8808, data in ./data

イメージには node/npx、uvx、git が同梱されているため、npm ベースおよび Python ベースの MCP サーバーをコンテナ内で起動できます。ポートが他の人から到達可能な場合は、環境変数 GATEWAY_ADMIN_TOKEN を設定してください。設定を事前にロードするには、ファイルをマウントして GATEWAY_SEED_CONFIG=/path/to/config.json を設定します。初回起動時にデータボリュームへコピーされます。

全体像

設定は単一の JSON ファイル（data/config.json、モード 0600、アトミック書き込み、.bak 保持）です。全フィールドは docs/CONFIG.md を参照してください。各ツールのクライアント設定は docs/CLIENTS.md に、設計の全体は docs/SPEC.md にあります。GUI には組み込みの Docs ページ（Settings の隣の /docs）もあり、ゲートウェイの仕組みと、サーバーの追加・カスタマイズ・接続方法を順を追って説明しています。

CLI

mcp-gateway serve [--host 127.0.0.1] [--port 8808] [--data-dir ./data] [--config <file>] [--public-url <url>] [--log-level info]
mcp-gateway import <file> [--format gateway|mcpServers] [--mode merge|replace]    # into the config file (restart to apply)
mcp-gateway export [--format gateway|mcpServers] [--secrets] [--out <file>]
mcp-gateway hash-token <token>                                                     # sha256 for settings.auth.adminTokenHash
mcp-gateway connect <url> [--api-key K] [--header 'Name: v'] [--sse]              # stdio ⇄ HTTP bridge
mcp-gateway-connect <url> …                                                        # same bridge as a standalone package (@mcp-gateway/connect)

環境変数：GATEWAY_HOST、GATEWAY_PORT、GATEWAY_DATA_DIR、GATEWAY_CONFIG、GATEWAY_ADMIN_TOKEN、GATEWAY_PUBLIC_URL、GATEWAY_LOG_LEVEL、GATEWAY_REQUIRE_API_KEY、GATEWAY_WEB_DIR、GATEWAY_SEED_CONFIG（Docker）。優先順位：CLI フラグ > 環境変数 > config.json > デフォルト。

エンドポイント

リクエスト/レスポンスの形式を含む完全なルート一覧は docs/SPEC.md §7 にあります。

セキュリティに関する注意

• 管理トークンがない場合、GUI/API は開放されます。デフォルトのループバックバインドを維持するか、GATEWAY_ADMIN_TOKEN を設定してください。

• /mcp を localhost の外に公開する前に Require API key をオンにしてください。キーは、各エージェントが必要とするサーバー/グループにスコープしてください。

• シークレット：リテラル値ではなく ${VAR} 参照を優先してください。シークレットと思われるキーの値は、API レスポンスとエクスポートで秘匿（redaction）されます（?secrets=1 / シークレット付きエクスポートには含まれます）。

• インターネットに公開するものには、前面に TLS 終端のリバースプロキシを配置してください（Anthropic API MCP コネクタに必要です）。

• ゲートウェイは設定したコマンドを実行します。管理アクセス権を持つ人は誰でも、ホスト上で任意のプロセスを実行できます。

開発

npm run dev          # gateway (tsx watch) + Vite dev server
npm run typecheck    # all workspaces
npm test             # vitest: shared unit tests, server integration tests (real stdio/HTTP fixtures), bridge tests
npm run build        # server bundle (esbuild), connect bundle, web (vite)

構成：packages/shared（zod 設定スキーマ、DTO、テンプレート、命名ヘルパー — ブラウザセーフ）、packages/server（Express 5 + @modelcontextprotocol/sdk：アップストリームマネージャー、プロキシサーバー、セッション、REST/MCP ルート、CLI）、packages/web（React 19 + Vite）、packages/connect（stdio ブリッジ）、examples/postgres-scenario（docker-compose デモ）。

制限事項 / ロードマップ

• アップストリームサーバーへの OAuth は未実装です（bearer/basic/header 認証を使用してください）。ダウンストリームクライアント向けの OAuth も未実装です（代わりに API キーを使用します）。

• グループ内でリソースは名前空間化されません。URI は所有サーバーにルーティングされ、メンバー間で同一の URI は最初のメンバーに解決されます。

• レート制限はありません。必要であれば前面にリバースプロキシを配置してください。

• シングルプロセス、インメモリのセッションとログ（再起動するとセッションは失われ、クライアントは再初期化します）。

ライセンス

Apache License 2.0 — LICENSE と NOTICE を参照してください。