Switchback MCP

Switchback 用の MCP サーバー — AI エージェントのターンを複雑さで分類し、処理できる最も安価なモデルを選択します。Claude Desktop、Cursor、Cline、および任意の MCP クライアントにそのまま組み込めます。

VibeKit によって構築 — 当社のホステッド製品のすべての「Auto」ターンを支える同じカスケードルーターです。詳細はこちら →

機能

Model Context Protocol 上で2つのツールを公開します:

• classify_turn — ユーザーメッセージを受け取り、{tier: 0|1|2, why, fallback, durationMs} を返します。次のエージェントステップでフラッグシップモデルにコストをかけるか、安価なモデルに留まるかを判断するときに使用します。

• recommend_model — ユーザーメッセージとモデルのラダー（安価 → フラッグシップ）を受け取り、そのラダーの中で処理できそうな最も安価なモデルを返します。classify_turn の便利なラッパーです。

両方のツールは OpenRouter 経由で単一の小規模モデル呼び出しを行います（デフォルト: openai/gpt-5.4-mini、約 $0.0001/回）。フェイルソフト: エラーが発生した場合は、エージェントをブロックせずに fallback: true 付きの tier 1 を返します。

Related MCP server: oracle-models

インストール

npm install -g vibekit-switchback-mcp

設定

OpenRouter キーを設定してください（https://openrouter.ai/keys で取得できます）:

export OPENROUTER_API_KEY=sk-or-...

オプション: 分類モデルを上書きする:

export SWITCHBACK_CLASSIFIER_MODEL=anthropic/claude-haiku-4.5

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加してください:

{
  "mcpServers": {
    "switchback": {
      "command": "npx",
      "args": ["-y", "vibekit-switchback-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}

Cursor / Cline / その他

stdio サーバーをサポートする任意の MCP クライアント。同じ npx 呼び出しを使用します。

呼び出し例

classify_turn:

{
  "userMessage": "rebuild the auth flow with passkeys"
}

返り値:

{
  "tier": 2,
  "why": "architectural rework + new auth method",
  "fallback": false,
  "durationMs": 412
}

recommend_model:

{
  "userMessage": "fix typo in README",
  "ladder": [
    "openai/gpt-5.4-mini",
    "openai/gpt-5.4",
    "openai/gpt-5.5"
  ]
}

返り値:

{
  "recommended_model": "openai/gpt-5.4-mini",
  "tier": 0,
  "ladder_size": 3,
  "classifier": { "tier": 0, "why": "trivial copy edit", "fallback": false, "durationMs": 318 }
}

使用すべき場面

• マルチステップエージェント — ラウンド間でモデルを切り替えられる場合。

• BYOK スタイルの製品 — すべてのルーティングをユーザーが選択したブランド内に留めたい場合。ユーザーごとにブランド固定のラダーを渡します。

• コスト重視のオーケストレーター — 些細なターンにフラッグシップ料金を費やさないようにしたい場合。

使用すべきでない場面

• ワンショットチャット補完 — 最初の呼び出し後にモデルを変更できない場合。代わりに OpenRouter の auto または NotDiamond/Martian を使用してください。

• レイテンシが重要な 200ms 未満のファーストトークン UX — 分類器は 200〜500ms 追加します。

ライセンス

MIT。 LICENSE を参照してください。

VibeKit によって構築されました。コアライブラリは vibekit-switchback です — このパッケージは MCP ラッパーです。