Compass MCP

本地 MCP，读取你正在做的事情并建议适合的模型——文案微调、UI 还是棘手的 bug，诸如此类。

运行方式

每个真实任务都应通过 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 经常添加模型。大约每月（或当 Cursor Models 选择器变化时）对照 Models & Pricing 重新检查 src/recommend.ts / src/hosts.ts 中的 Task slug。然后运行 npm run sync 并在 Customize → MCPs 中切换 MCP。

使用方法

在聊天中直接说出你在做什么。代理会调用 Compass 并获得模型建议。

示例：

• “我应该用什么模型来做这个？”

• “用 Fable 修复登录文案”

• “调试这个不稳定的类型错误回归”

如果你想指定模型就说出来（페이블로、use codex）——这优先于评分。

它通常选什么

Cursor 目录（Task slug）

“最轻量”取决于主机——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 也能用。

• 远程 Web 连接器是可选的（见下文）。

远程 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 slug 是 composer-2.5-fast 回退，聊天 UI 推荐 Standard。Cursor 代表模型全部（Sonnet/Opus 4.8·5/Fable/Grok/Sol/Terra/Kimi）目录排序。必须把 copy_task_model 复制到 Task 的 model=（只说不 switch=违规）。