Switchback MCP

MCP-сервер для Switchback — классифицирует ходы AI-агента по сложности и выбирает самую дешёвую модель, которая с ними справится. Подходит для Claude Desktop, Cursor, Cline и любого MCP-клиента.

Создано VibeKit — тот же каскадный маршрутизатор, который обеспечивает каждый ход «Auto» в нашем облачном продукте. Узнать больше →

Что делает

Предоставляет два инструмента через Model Context Protocol:

• classify_turn — принимает сообщение пользователя и возвращает {tier: 0|1|2, why, fallback, durationMs}. Используйте его, когда решаете, потратиться ли на флагманскую модель или остаться на дешёвой для следующего шага агента.

• recommend_model — принимает сообщение пользователя и лестницу моделей (дешёвая → флагманская) и возвращает самую дешёвую модель из лестницы, которая правдоподобно справится с задачей. Удобная обёртка вокруг classify_turn.

Оба инструмента выполняют один вызов небольшой модели через OpenRouter (по умолчанию: openai/gpt-5.4-mini, ~$0.0001 за вызов). Мягкий отказ: любая ошибка возвращает tier 1 с fallback: true, а не блокирует вашего агента.

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 / другие

Любой MCP-клиент, поддерживающий stdio-серверы. Та же команда 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, где вы хотите сохранить всю маршрутизацию внутри выбранного пользователем бренда — передавайте лестницу, привязанную к бренду, для каждого пользователя.

• Экономные оркестраторы, которые хотят избежать трат на флагманские тарифы для тривиальных ходов.

Когда НЕ использовать

• Одноразовые чат-завершения, где нельзя сменить модель после первого вызова — используйте auto от OpenRouter или NotDiamond/Martian.

• Латентно-критичный UX с первым токеном менее 200 мс — классификатор добавляет 200-500 мс.

Лицензия

MIT. См. LICENSE.

Создано VibeKit. Основная библиотека — vibekit-switchback, а этот пакет — MCP-обёртка.