MCP Server Proxy

🚀 MCP サーバープロキシ

このプロキシサーバーは、複数の MCP サーバーに接続し、ツールがアクセスするための統一インターフェイスを提供します。

✨ 主な機能

• 複数の MCP サーバーに同時接続
• 複数の設定ファイルをサポート
• ツール名にサーバー名の接頭辞を付加
• “stdio”または“SSE”モードでの実行が可能
• 設定ファイルに基づく管理

📦 インストール

npm install

📚 ドキュメント

設定

各設定ファイルには config.<profile>.json という名前のファイルを作成します。例えば：

// config.developer.json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

// config.personal.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/mirilale/Desktop"
      ]
    }
  }
}

使用方法

コマンドラインオプション

サーバーは以下のコマンドラインオプションで起動できます：

# デフォルト設定で起動
node dist/server.js

# 特定の設定ファイルで起動
node dist/server.js --profile developer
# または
node dist/server.js -p developer

# SSE モードで起動
node dist/server.js --mode sse
# または
node dist/server.js -m sse

# SSE モードでカスタムポートとホストを使用
node dist/server.js --mode sse --port 8080 --host 0.0.0.0

# オプションを組み合わせる
node dist/server.js --profile developer --mode sse --port 8080

利用可能なオプション：

• -p, --profile <name>: 使用する設定ファイルの名前を指定（デフォルトは "default"）
• -m, --mode <mode>: “stdio”または“sse”モードを選択（デフォルトは "stdio"）
• --port <number>: SSE モードのポートを設定（デフォルトは 3000）
• --host <host>: SSE モードのホストを設定（デフォルトは "localhost"）

ヘルプを取得するには：

node dist/server.js --help

ツール命名規則

ツール名にはそのサーバー名の接頭辞が付きます。例えば：

• “filesystem”サーバーのツール“read_file”は“filesystem_read_file”になります。
• “kubernetes”サーバーのツール“get_pods”は“kubernetes_get_pods”になります。

SSE モードエンドポイント

SSE モードでは、サーバーは以下のエンドポイントを公開します：

• GET /sse: SSE 接続を確立
• POST /messages: ツールリクエストを処理（sessionId クエリパラメータを提供する必要があります）

SSE クライアントの使用例：

const eventSource = new EventSource("http://localhost:3000/sse");
eventSource.onmessage = (event) => {
  console.log("受信:", event.data);
};

エラー処理

サーバーは詳細なエラー情報を提供します。これには以下が含まれます：

• 設定ファイルの読み込みエラー
• サーバー接続失敗エラー
• ツールが見つからないエラー
• サーバー切断エラー

すべてのエラーメッセージには、より良いコンテキストを提供するために現在の設定ファイル名が含まれます。

開発

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# 開発モードで実行（stdio モード）
npm run dev:stdio:developer
# または
npm run dev:sse:developer

# mpc チェックツールを使用
npm run inspect

📄 ライセンス

MIT