MuiRouter

Model Context Protocol (MCP) ルーター & ゲートウェイ

MCP ルーター & 複数サーバー統合設定ガイド

MuiRouter は高性能な streamable-HTTP MCP サーバーおよびルーターを提供します。Claude Desktop、Claude Code、Cursor、Cline などの AI クライアントから接続し、LLM のルーティング、複数ローカル/リモート MCP サーバーの統合集約、内蔵アカウントツールの操作をすべて 1 つの API キーで実行できます。

1. デュアル Era プロトコル仕様対応
最新の 2026-07-28 ステートレス streamable-HTTP 仕様に完全対応し、2025-11-25 / 2025-06-18 の旧クライアントともシームレスに互換性を維持します。

Modern 仕様 (2026-07-28): ステートレス streamable-HTTP、明示的な _meta とヘッダー(MCP-Protocol-Version)検証、server/discover 動的検出、DNS rebinding 保護。

Legacy 互換 (2025-11-25 / 2025-06-18): initialize ハンドシェイクに対応し、既存クライアントの安全な接続を保証。

2. サーバーエンドポイントと認証
すべての MCP クライアントは同じ streamable-HTTP URL に接続し、Bearer 認証で統一管理されます。
Endpoint
POST https://api.muirouter.com/mcp
Header
Authorization: Bearer sk-gw-xxxxxxxx
3. 複数サーバー統合集約(Claude Code 設定例)
~/.claude/mcp.json に MuiRouter とローカル MCP サーバーを併記し、中央集権ルーティングを実現します。
{
  "mcpServers": {
    "muirouter": {
      "url": "https://api.muirouter.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-gw-xxxxxxxx"
      }
    },
    "local-tools": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

Claude Code 再起動後に /mcp と入力すると、接続された全サーバーの集約済みツール一覧を確認できます。

4. Cursor / Claude Desktop / Cline での接続
同じ streamable-HTTP エンドポイントと Authorization ヘッダーで設定します。

Cursor: Settings → MCP → Add new server、streamable-http を選択し、URL に https://api.muirouter.com/mcp、ヘッダーに Authorization: Bearer sk-gw-... を追加。

Claude Desktop: 設定ファイル(~/Library/Application Support/Claude/claude_desktop_config.json)を上記と同じ JSON 設定で編集します。

5. 内蔵アカウント & AI ツール一覧
モデルルーティング、残高確認、使用量統計、画像生成、決済を網羅する 6 つの内蔵ツール。
get_balance

現在の API キーを所有するユーザーのウォレット残高、累計チャージ額、累計支出額を照会します。

{ "name": "get_balance", "arguments": {} }
get_usage

現在のユーザーの API 使用量をページ送りで取得します。モデルと期間で絞り込めます。

{ "name": "get_usage", "arguments": { "limit": 20, "model": "gpt-4o" } }
list_recharges

現在のユーザーのチャージ履歴をページ送りで取得します。

{ "name": "list_recharges", "arguments": { "limit": 20 } }
list_models

MuiRouter が現在サポートしているすべてのモデルとその料金(input/output、markup_rate)を一覧表示します。

{ "name": "list_models", "arguments": {} }
create_topup_session

Stripe のチャージセッションを作成し、AI クライアントがユーザーを案内できる決済リンクを返します。

{ "name": "create_topup_session", "arguments": { "amount_cents": 1000, "currency": "usd" } }
image_generation

MuiRouter 経由で OpenAI 互换の画像生成エンドポイントを呼び出します(ウォレット残高を消費します)。

{ "name": "image_generation", "arguments": { "model": "gpt-image-2", "prompt": "a cute cat" } }
6. JSON-RPC 直接実行 & curl デバッグ
クライアントなしでも curl を使用して機能検出、ツール一覧、ツール呼び出しを直接テストできます。
# Discover server capabilities (Modern 2026-07-28)
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"protocolVersion":"2026-07-28"}}}'

# List tools
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Call get_balance
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":3,
    "method":"tools/call",
    "params": {"name":"get_balance","arguments":{}}
  }'
7. セキュリティとベストプラクティス

API キーは認証情報です。公開リポジトリ等に絶対に露出させず、漏洩の疑いがある場合は直ちに Keys ページで無効化してください。

画像生成やチャージ作成は残高に影響します。AI クライアントでこれらのツールに確認ステップを設けることを推奨します。

Origin 検証により DNS rebinding 攻撃を遮断。REST API と同等の並行性および課金ルールが適用されます。

関連ガイド & 比較