Switchback MCP

Switchback용 MCP 서버 — 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). 실패 시 안전하게 작동합니다: 오류가 발생하면 에이전트를 차단하는 대신 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 래퍼입니다.