omni-mcp

概要

OmniRoute MCP サーバーに接続します（ツール 110 個、トランスポート 3 種類：SSE／stdio／HTTP）。33 の権限スコープにわたり、ルーティング、キャッシュ、圧縮、メモリ、スキル、プロバイダー、監査ツールを網羅しています。

認証

すべてのリクエストには、有効な Bearer トークンまたはセッション Cookie が必要です。POST /api/auth/login でトークンを取得するか、ローカル開発用に REQUIRE_API_KEY=false を設定してください。

エンドポイント

GET /api/mcp/audit

GET mcp › audit

curl http://localhost:20128/api/mcp/audit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/audit/stats

GET mcp › audit › stats

curl http://localhost:20128/api/mcp/audit/stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/sse

GET mcp › sse

curl http://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/mcp/sse

POST mcp › sse

curl -X POST http://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/mcp/status

GET mcp › status

curl http://localhost:20128/api/mcp/status \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/stream

GET mcp › stream

curl http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/mcp/stream

POST mcp › stream

curl -X POST http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/mcp/stream

DELETE mcp › stream

curl -X DELETE http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/tools

GET mcp › tools

curl http://localhost:20128/api/mcp/tools \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

ペイロード

詳細なリクエスト／レスポンスのスキーマについては、GET /api/openapi/spec または docs/openapi.yaml の完全な OpenAPI 仕様を参照してください。

OmniRoute — MCP サーバー

OMNIROUTE_URL と OMNIROUTE_KEY が必要です。セットアップについては、エントリーポイントの SKILL を参照してください。

トランスポート

• stdio — ローカル IPC。Claude Desktop／VS Code 拡張機能向け
• SSE — GET $OMNIROUTE_URL/api/mcp/sse
• Streamable HTTP — POST $OMNIROUTE_URL/api/mcp/stream

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "omniroute": {
      "command": "npx",
      "args": ["-y", "omniroute", "--mcp"],
      "env": { "OMNIROUTE_KEY": "sk-..." }
    }
  }
}

Cursor／VS Code の設定

{
  "mcp": {
    "servers": {
      "omniroute": {
        "url": "http://localhost:20128/api/mcp/sse",
        "headers": { "Authorization": "Bearer sk-..." }
      }
    }
  }
}

コアツールの例（ライブカタログ：ツール 110 個）

以下の表に代表的なコアツールを示します。サーバーのディスカバリーレスポンスが正式な情報源であり、110 個すべてのツールが含まれています。

スコープ	ツール
health	omniroute_get_health
combos	omniroute_list_combos, omniroute_get_combo_metrics, omniroute_switch_combo
routing	omniroute_simulate_route, omniroute_best_combo_for_task, omniroute_explain_route
providers	omniroute_get_provider_metrics, omniroute_check_quota, omniroute_route_request
budget	omniroute_set_budget_guard, omniroute_set_routing_strategy, omniroute_set_resilience_profile
testing	omniroute_test_combo
memory	memory_add, memory_search, memory_delete
skills	skill_invoke, skill_list, skill_describe, skill_register
cache	omniroute_cache_stats, omniroute_cache_flush
admin	omniroute_db_health_check, omniroute_sync_pricing, omniroute_get_session_snapshot

全リスト：GET $OMNIROUTE_URL/api/mcp/tools

スコープ

ツールは 33 のスコープ（チャット専用、メモリ読み取り専用、管理者向けフルアクセスなど）に分類されています。 スコープ名を --scope 引数として、または X-Omniroute-Scope ヘッダーで渡してください。

リファレンス

ドキュメント全文：https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/MCP-SERVER.md