Compass MCP

현재 작업을 읽고 어떤 모델이 맞는지 추천하는 로컬 MCP — 카피 수정 vs UI vs 골치 아픈 버그 같은 것.

실행 방식

각 실제 작업은 start_session (compact)을 한 번 통과해야 합니다. 기본은 저렴한 모델, 작업이 필요할 때만 더 무거운 모델을 사용합니다. 에이전트는 작업 시작 시 이를 호출하는 워크스페이스 규칙을 따릅니다(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는 모델을 자주 추가합니다. src/recommend.ts / src/hosts.ts의 Task 슬러그를 Models & Pricing과 대략 월 1회(또는 Cursor Models 선택기가 변경될 때) 다시 확인하세요. 그런 다음 npm run sync을 실행하고 Customize → MCPs에서 MCP를 껐다 켜세요.

사용법

채팅에서 하고 있는 일을 말하기만 하세요. 에이전트가 Compass를 호출하고 모델 추천을 받습니다.

예시:

• "이 작업에 어떤 모델을 써야 할까요?"

• "Fable로 로그인 카피 수정"

• "이 간헐적 타입 오류 회귀 디버깅"

원하면 모델 이름을 말하세요(페이블로, use codex) — 점수보다 우선합니다.

일반적인 선택

Cursor 카탈로그(Task 슬러그)

"가장 가벼운"은 호스트에 따라 다릅니다 — Cursor의 저렴한 슬롯은 Composer이지 Haiku가 아닙니다. 최상위 추천을 사용할 수 없으면 목록의 다음으로 폴백합니다.

제한 사항

• 채팅 드롭다운을 대신 변경하지 않습니다 — 사용자 또는 에이전트가 여전히 모델을 선택합니다.

• 실패 모드: Task model=에 must_do.task_model(copy_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로 터널링하고 커넥터를 Authorization: Bearer <key>와 함께 /mcp로 지정하세요. 대부분의 사용자에게는 로컬 stdio(npm run connect)로 충분합니다.

라이선스

MIT

한국어: 작업 문장 보고 모델 추천하는 로컬 MCP (v0.9.7+). npm run connect -- cursor|claude|codex 한 줄 설치. 간단 작업은 Composer 2.5 Standard(Fast 아님) — Task slug는 composer-2.5-fast fallback, 채팅 UI는 Standard 권장. Cursor 대표 모델 전체( Sonnet/Opus 4.8·5/Fable/Grok/Sol/Terra/Kimi ) 카탈로그 정렬. copy_task_model을 Task model=에 복사해야 함(말만 switch=위반).