Compass MCP

Локальный MCP, который считывает, что вы делаете, и предлагает, какая модель подходит — правка текста против UI против противного бага, в таком духе.

Как это работает

Каждая реальная задача должна один раз пройти через start_session (компактно): по умолчанию дешёвая модель, более тяжёлая — только когда задача этого требует. Агенты следуют правилам рабочего пространства и вызывают его в начале работы (включая Multitask / субагентов — не пропускайте). Cursor не переключает автоматически выпадающий список чата и не перехватывает каждое сообщение — скопируйте copy_task_model в Task model=. Та же задача + stick_action=keep → без повторной рекомендации (кроме случаев, когда тип работы переключается на планирование/архитектуру). Если пользователь произносит тестовую фразу только для промпта, всё равно вызовите start_session или recommend_model; не реализуйте.

Related MCP server: MCP Router

Установка

git clone https://github.com/JakeLim17/compass-mcp.git
cd compass-mcp
npm run connect -- cursor
npm run connect -- claude
npm run connect -- codex

Выберите одну строку хоста. Она установит, соберёт и запишет вашу конфигурацию MCP (существующая конфигурация сначала резервируется).

Затем перезапустите приложение. В Cursor: боковая панель Customize → MCPs → выключите и включите.

Не в npm — клонируйте с GitHub. Обновления: npm run sync.

Обслуживание каталога: Cursor часто добавляет модели. Перепроверяйте Task-слаги в src/recommend.ts / src/hosts.ts по Models & Pricing примерно раз в месяц (или когда меняется выбор моделей Cursor). Затем npm run sync и переключите MCP в Customize → MCPs.

Использование

Просто скажите в чате, что вы делаете. Агент вызывает Compass и получает предложение по модели.

Примеры:

• «Какую модель мне использовать для этого?»

• «Исправь текст логина с помощью Fable»

• «Отладь эту капризную регрессию с ошибкой типов»

Назовите модель, если хотите (페이블로, use codex) — это перевешивает оценку.

Что она обычно выбирает

Каталог Cursor (Task-слаги)

«Самая лёгкая» зависит от хоста — дешёвая позиция Cursor — это Composer, а не Haiku. Если лучший вариант недоступен, используется следующий по списку.

Ограничения

• Не меняет выпадающий список чата за вас — модель всё равно выбираете вы или агент.

• Режим отказа: произнесение «추천 모델로 다시» без помещения must_do.task_model (copy_task_model) в Task model= оставляет Composer. Cursor MCP не может автоматически привязать Task. task_model_required + правила обеспечивают копирование; verify_run_compliance не видит родительскую среду выполнения чата.

• Cursor — основная цель; Claude Code и Codex CLI тоже работают.

• Удалённые веб-коннекторы опциональны (см. ниже).

Удалённый HTTP (опционально)

Для коннекторов Claude.ai / ChatGPT, не для повседневного Cursor:

export COMPASS_MCP_API_KEY="$(openssl rand -hex 32)"
npm run start:http
# → http://127.0.0.1:3920/mcp

Прокиньте этот порт через HTTPS и укажите коннектору /mcp с Authorization: Bearer <key>. Локального stdio (npm run connect) достаточно для большинства.

Лицензия

MIT

Корейский: локальный MCP, который смотрит на рабочую фразу и рекомендует модель (v0.9.7+). Установка одной строкой npm run connect -- cursor|claude|codex. Для простых задач — Composer 2.5 Standard (не Fast) — Task-слаг composer-2.5-fast как фолбэк, для чат-UI рекомендуется Standard. Каталог всех основных моделей Cursor (Sonnet/Opus 4.8·5/Fable/Grok/Sol/Terra/Kimi) отсортирован. copy_task_model нужно скопировать в Task model= (просто сказать switch = нарушение).