MCP Proxy Server について
MCP Proxy Server は複数の MCP サーバーを単一の HTTP エントリポイントの背後にまとめる MCP プロキシです。複数の MCP サーバーへの接続を一つのエンドポイントに集約したい開発者やチームを対象とし、下流サービスの OAuth トークンをプロキシが保持して更新します。
主な機能
- 01複数の MCP サーバーのツール、プロンプト、リソースを集約
- 02Server-Sent Events と streamable HTTP での提供
- 03stdio、sse、streamable-http の各クライアントタイプに対応
- 04下流サービスの OAuth トークンを保持し更新
- 05npx および uvx で起動するサーバーを実行できる Docker イメージ
活用シーン
- 01複数の MCP サーバーを一つのアドレスからクライアントに提供
- 02対話型 OAuth が必要な下流サービスへの一括認可
- 03共有 MCP プロキシのコンテナとしての運用
MCP 対応
MCP Proxy Server は下流の複数の MCP サーバーに接続する MCP クライアントとして動作すると同時に、集約したツール、プロンプト、リソースを上流のクライアントに公開する MCP サーバーとして動作します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.amap.com/sse?key=<YOUR_TOKEN>claude mcp add --transport http proxy-tbxark https://mcp.amap.com/sse?key=<YOUR_TOKEN>{"mcpServers":{"proxy-tbxark":{"type":"http","url":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}Cursor で開く{"servers":{"proxy-tbxark":{"type":"http","url":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}VS Code で開く{"mcpServers":{"proxy-tbxark":{"type":"http","url":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}{"mcpServers":{"proxy-tbxark":{"serverUrl":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
26| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| branch | string | はい | ファイルを作成または更新するブランチ |
| content | string | はい | ファイルの内容 |
| message | string | はい | コミットメッセージ |
| owner | string | はい | リポジトリの所有者(ユーザー名または組織) |
| path | string | はい | ファイルを作成または更新するパス |
| repo | string | はい | リポジトリ名 |
| sha | string | いいえ | 置き換えるファイルの SHA(既存ファイルの更新時に必須) |
詳細
MCP プロキシサーバー
複数の MCP サーバーを単一の HTTP エントリーポイントの背後に集約する MCP プロキシです。
特長
- 複数の MCP クライアントをプロキシ:多数のサーバーのツール、プロンプト、リソースを集約します。
- SSE とストリーミング可能な HTTP:Server‑Sent Events またはストリーミング可能な HTTP で提供します。
- 柔軟な設定:
stdio、sse、streamable-httpのクライアントタイプに対応しています。 - OAuth クライアントのサポート:インタラクティブな OAuth が必要な下流サーバー(Notion など)に一度認証すれば、プロキシがすべての呼び出し元のためにトークンを保持し、更新します。
ドキュメント
- 設定:docs/configuration.md
- 使用方法:docs/usage.md
- デプロイ:docs/deployment.md
- Claude 設定コンバーター:https://tbxark.github.io/mcp-proxy
クイックスタート
ソースからビルド
git clone https://github.com/tbxark/mcp-proxy.git
cd mcp-proxy
make build
./build/mcp-proxy --config path/to/config.json
Go 経由でインストール
go install github.com/tbxark/mcp-proxy@latest
Docker
このイメージには、npx と uvx を介して MCP サーバーを起動するためのサポートが含まれています。
docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest
# or provide a remote config
docker run -d -p 9090:9090 ghcr.io/tbxark/mcp-proxy:latest --config https://example.com/config.json
docker‑compose を含むその他のデプロイ方法については、docs/deployment.mdをご覧ください。
設定
設定の完全なリファレンスと例については、docs/configuration.mdをご覧ください。 オンラインの Claude 設定コンバーターはこちらです:https://tbxark.github.io/mcp-proxy
使用方法
コマンドラインフラグ、エンドポイント、認証の例については、docs/usage.mdをご覧ください。
謝辞
- このプロジェクトは、adamwattis/mcp-proxy-serverプロジェクトに着想を得ています。
- デプロイに関するご質問は、《Docker サンドボックスで MCP Server を実行する》(@ccbikai)をご覧ください。
ライセンス
このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSEファイルをご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。