MCP Proxy Nodejs

🚀 MCP SSE Proxy

MCP（Model Context Protocol）サーバーのプロキシで、STDIOベースのMCPクライアントとSSE（Server-Sent Events）ベースのMCPサーバーを橋渡しします。これにより、STDIOトランスポートのみをサポートするMCPクライアントが、SSEトランスポートを使用するリモートのMCPサーバーに接続できるようになります。

🚀 クイックスタート

MCP SSE Proxyは、2つの異なるMCPトランスポートプロトコル間の橋渡しを行います。

• STDIOトランスポート：ローカルのMCPクライアント（Claude Desktopなど）で使用されます。
• SSEトランスポート：HTTP/HTTPSを介してアクセス可能なリモートのMCPサーバーで使用されます。

このプロキシを使用すると、STDIOベースのMCP接続のみをサポートするアプリケーションから、SSEエンドポイントを公開するリモートのMCPサーバーを利用できます。

✨ 主な機能

• 完全なMCPプロトコルサポート：以下を含むすべてのMCP機能をプロキシします。
  • ツール（一覧表示と呼び出し）
  • リソース（一覧表示と読み取り）
  • リソーステンプレート（一覧表示）
  • プロンプト（一覧表示と取得）
• 認証サポート：SSEエンドポイントに対するオプションのAPIキー認証。
• エラーハンドリング：詳細なログを伴う包括的なエラーハンドリング。
• 正常なシャットダウン：プロセス終了時の適切なクリーンアップ。
• 設定可能：コマンドライン引数または環境変数による柔軟な設定。

📦 インストール

前提条件

• Node.js >= 18.0.0
• npmまたはyarn

セットアップ

1. このリポジトリをクローンまたはダウンロードします。
2. 依存関係をインストールします。

npm install

💻 使用例

基本的な使用法

node server/index.js <SERVER_NAME> <SSE_URL> [API_KEY]

パラメーター:

• SERVER_NAME: MCPサーバーの表示名
• SSE_URL: リモートのSSE MCPサーバーエンドポイントのURL
• API_KEY: (オプション) 認証用のAPIキー

例:

node server/index.js "My Remote MCP Server" "https://api.example.com/mcp/sse" "your-api-key"

高度な使用法

環境変数を使用することもできます。

export SERVER_NAME="My Remote MCP Server"
export SSE_URL="https://api.example.com/mcp/sse"
export API_KEY="your-api-key"
node server/index.js

📚 ドキュメント

MCPクライアントの設定

Claude DesktopのようなMCPクライアントでこのプロキシを使用するには、MCP設定に以下を追加します。

{
  "mcpServers": {
    "remote-server": {
      "command": "node",
      "args": [
        "/path/to/mcp-proxy-node/server/index.js",
        "Remote Server Name",
        "https://your-remote-server.com/mcp/sse",
        "your-api-key"
      ]
    }
  }
}

認証

このプロキシはBearerトークン認証をサポートしています。APIキーが提供された場合、以下のように送信されます。

• HTTPリクエストでは Authorization: Bearer <API_KEY> ヘッダー。
• EventSource接続では認証ヘッダー。

デスクトップ拡張機能（.dxt）の作成

このMCPプロキシは、Claude Desktopや他のMCP対応アプリケーションで簡単にワンクリックインストールできるデスクトップ拡張機能としてパッケージ化できます。

詳細ガイドについては、Desktop Extensions: One-click MCP server installation for Claude Desktop を参照してください。

前提条件

依存関係をインストールします。

npm install

DXT CLIツールをインストールします。

npm install -g @anthropic-ai/dxt

DXTファイルの作成手順

1. DXT設定の初期化 (必要な場合):

   dxt init
   

   注: このプロジェクトにはすでに manifest.json ファイルが含まれているため、初期化は必要ない場合があります。
2. マニフェストの検証:

   dxt validate
   

3. 拡張機能のパッケージ化:

   dxt pack
   

4. 拡張機能のテスト:
   • コマンドにより .dxt ファイルが生成されます。
   • .dxt ファイルをClaude Desktopの設定ウィンドウにドラッグアンドドロップします。
   • 「インストール」をクリックして拡張機能をテストします。

クイックインストール（別の方法）

拡張機能を自分でビルドしたくない場合は、事前にビルドされた mcp-proxy-node.dxt ファイルをClaude Desktopの設定ウィンドウに直接ドラッグアンドドロップしてすぐにインストールできます。

スクリーンショット

インストール後のClaude Desktopに表示されるMCP SSE Proxy拡張機能。ユーザーは直感的なインターフェイスを通じてサーバー名、SSE URL、APIキーを簡単に設定できます。

🔧 技術詳細

アーキテクチャ

MCP Client (STDIO) ←→ MCP SSE Proxy ←→ Remote MCP Server (SSE)

このプロキシは2つの主要なコンポーネントで構成されています。

1. MCPサーバー：ローカルのMCPクライアントからのSTDIO接続を受け付けます。
2. MCPクライアント：リモートのSSE MCPサーバーに接続します。

トランスポートプロトコル

• 入力：STDIOトランスポート（標準入出力）
• 出力：SSEトランスポート（HTTP/HTTPSを介したServer-Sent Events）

エラーハンドリング

このプロキシには包括的なエラーハンドリングが含まれています。

• リモートのSSEサーバーへの接続失敗
• 無効なURL形式
• 認証エラー
• リクエスト/レスポンスの解析エラー
• リモートの機能が利用できない場合の正常な劣化

ロギング

デバッグ用に console.error() を介して詳細なログが提供されます。

• 接続状態
• リクエスト/レスポンスの詳細
• スタックトレース付きのエラー情報
• パフォーマンスメトリクス

📄 APIドキュメント

MCPSSEProxyクラス

コンストラクタ

new MCPSSEProxy(sseUrl, apiKey, serverName)

• sseUrl (文字列): SSE MCPサーバーのURL
• apiKey (文字列, オプション): 認証用のAPIキー
• serverName (文字列): プロキシサーバーの表示名

メソッド

• initialize(): クライアントとサーバーの接続を初期化します。
• run(): プロキシサーバーを起動します。
• close(): プロキシを正常にシャットダウンします。
• setupProxyHandlers(): リクエストハンドラーを設定します。

🛠️ 開発

プロジェクト構造

mcp-proxy-node/
├── server/
│   └── index.js          # メインのプロキシサーバー実装
├── package.json          # プロジェクト設定と依存関係
├── manifest.json         # MCPクライアント統合用のDXTマニフェスト
├── favicon.png          # プロジェクトアイコン
└── README.md            # このファイル

依存関係

• @modelcontextprotocol/sdk: Node.js用の公式MCP SDK

コントリビュート方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 十分にテストします。
5. プルリクエストを送信します。

🐞 トラブルシューティング

一般的な問題

1. 接続拒否
   • SSE URLが正しくアクセス可能であることを確認します。
   • リモートサーバーが実行中であることを確認します。
   • ファイアウォール/ネットワーク設定が接続を許可していることを確認します。
2. 認証エラー
   • APIキーが正しいことを確認します。
   • リモートサーバーが認証を要求していることを確認します。
   • APIキーの形式がサーバーの期待値と一致することを確認します。
3. ツール/リソースが利用できない
   • リモートサーバーが実際にツール/リソースを提供していることを確認します。
   • リモートサーバーが正しく応答していることを確認します。
   • プロキシのログにエラーメッセージがないか確認します。
4. パフォーマンスの問題
   • リモートサーバーへのネットワーク遅延を監視します。
   • リモートサーバーのレート制限を確認します。
   • 高頻度使用の場合はコネクションプーリングを検討します。

デバッグ

コンソール出力を調べることで詳細なログを有効にします。プロキシは以下をログに記録します。

• 接続試行と結果
• リクエスト/レスポンスの詳細
• スタックトレース付きのエラーメッセージ
• パフォーマンスタイミング

コミュニティに参加してサポートと更新情報を得ましょう

👉 Slackコミュニティ - AI in Ads

他のプロジェクトもチェックしてみましょう

👉 Facebook Ads MCP - Facebook Ads MCP 👉 Google Ads MCP - Google Ads MCP

ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

サポート

問題や質問については、以下を行ってください。

• 上記のトラブルシューティングセクションを確認します。
• コンソールログを確認してエラー詳細を取得します。
• Node.jsのバージョンが要件（>= 18.0.0）を満たしていることを確認します。
• リモートのSSEサーバーがMCPプロトコルと互換性があることを確認します。

互換性

• Node.js: >= 18.0.0
• MCPプロトコル: MCP SDK v1.13.2+と互換性があります。
• プラットフォーム: macOS、Windows、Linux
• Claude Desktop: >= 0.10.0

❤️ MCPコミュニティのために作られました