Compass MCP

MCP local que lee lo que estás haciendo y sugiere qué modelo encaja — ajuste de copy vs UI vs bug molesto, ese tipo de cosas.

Cómo funciona

Cada tarea real debe pasar por start_session (compacto) una vez: modelo barato por defecto, más pesado solo cuando la tarea lo requiere. Los agentes siguen las reglas del workspace para llamarlo al inicio del trabajo (incluido Multitask / subagentes — no lo omitas). Cursor no cambia automáticamente el desplegable del chat ni intercepta cada mensaje — copia copy_task_model en model= de Task. Misma tarea + stick_action=keep → sin recomendación repetida (excepto cuando el tipo de trabajo cambia a planificación/arquitectura). Si el usuario dice una frase de prueba solo de prompt, aun así llama a start_session o recommend_model; no lo implementes.

Related MCP server: MCP Router

Instalación

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

Elige una línea de host. Instala, compila y escribe tu configuración de MCP (la configuración existente se respalda primero).

Luego reinicia la aplicación. En Cursor: barra lateral Customize → MCPs → desactiva y activa.

No está en npm — clónalo desde GitHub. Actualizaciones: npm run sync.

Mantenimiento del catálogo: Cursor añade modelos a menudo. Revisa los slugs de Task en src/recommend.ts / src/hosts.ts contra Models & Pricing aproximadamente mensualmente (o cuando cambie el selector de Modelos de Cursor). Luego npm run sync y alterna MCP en Customize → MCPs.

Úsalo

Solo di lo que estás haciendo en el chat. El agente llama a Compass y obtiene una sugerencia de modelo.

Ejemplos:

• "¿Qué modelo debería usar para esto?"

• "Arregla el copy del login con Fable"

• "Depura esta regresión de error de tipos intermitente"

Di un nombre de modelo si quieres (페이블로, use codex) — eso gana sobre la puntuación.

Lo que suele elegir

Catálogo de Cursor (slugs de Task)

"El más ligero" depende del host — el slot barato de Cursor es Composer, no Haiku. Si la mejor opción no está disponible, cae a la siguiente en la lista.

Límites

• No cambia el desplegable del chat por ti — tú o el agente siguen eligiendo el modelo.

• Modo de fallo: decir "추천 모델로 다시" sin poner must_do.task_model (copy_task_model) en model= de Task deja Composer. El MCP de Cursor no puede vincular Task automáticamente. task_model_required + reglas hacen cumplir la copia; verify_run_compliance no puede ver el runtime del chat padre.

• Cursor es el objetivo principal; Claude Code y Codex CLI también funcionan.

• Los conectores web remotos son opcionales (ver abajo).

HTTP remoto (opcional)

Para conectores de Claude.ai / ChatGPT, no para el uso diario de Cursor:

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

Tuneliza ese puerto sobre HTTPS y apunta el conector a /mcp con Authorization: Bearer <key>. El stdio local (npm run connect) es suficiente para la mayoría.

Licencia

MIT

Coreano: MCP local que recomienda modelos según la frase de trabajo (v0.9.7+). Instalación de una línea con npm run connect -- cursor|claude|codex. Para tareas simples, Composer 2.5 Standard (no Fast) — el slug de Task es composer-2.5-fast como fallback, se recomienda Standard para el chat UI. Catálogo ordenado de todos los modelos principales de Cursor (Sonnet/Opus 4.8·5/Fable/Grok/Sol/Terra/Kimi). Debes copiar copy_task_model en model= de Task (solo decirlo = violación).