use-mimo-bridge-mcp

使用 MiMo Bridge MCP

核心规则

把 MiMo Bridge 当作有边界的委派系统：Codex 负责规划和审查，MiMo 或 Reasonix 只在配置的安全边界内执行，最终合并、丢弃或继续任务的决定由 Codex 或用户作出。

默认从有界的 Review Package 开始，只有风险证据不足时，才读取相关 diff、文件或日志尾部。不要为了方便读取整个仓库、完整日志或完整 diff。

先选择正确的客户端

优先使用不依赖源码 node_modules 的发行客户端：

& "$env:LOCALAPPDATA\MiMoBridgeApp\MiMo Bridge Client.cmd" health

便携包中使用当前目录的 MiMo Bridge Client.cmd。只有明确在源码仓库开发时，才使用：

node .\scripts\mimo-bridge-client.mjs health

下文的 $Client 表示已经确认存在的发行客户端路径：

$Client = "$env:LOCALAPPDATA\MiMoBridgeApp\MiMo Bridge Client.cmd"

不要因为源码目录缺少 node_modules 或 @modelcontextprotocol/sdk 就判定客户端不可用；发行客户端只使用内置 Node 模块和 REST。

首次检查

1. 运行 & $Client health。
2. 确认 daemon.status="ok"、daemon.identity="mimo-bridge-local-daemon/v1" 和 mcp.status="ready"。
3. 检查 config.reload_required；为 true 时不要直接开始新任务。
4. 如果 Codex 中缺少 MCP 工具，确认 MCP 地址为 http://127.0.0.1:3210/mcp。配置传输变化通常需要重启 Codex或新开会话。

委派流程

1. 对含中文路径、空格、引号或多行目标的请求，创建 UTF-8 JSON 文件；不要用内联 PowerShell/Node 拼接 JSON。
2. 为每次逻辑任务生成唯一且稳定的 idempotency_key，超时或断线重试时复用同一个键和完全相同的参数；不同逻辑任务不得共用该键。
3. MiMo 使用 start；Reasonix 使用 agent-start --agent-id reasonix-tui。
4. 新任务应在 5 秒内返回 task_id、request_id、status="preparing_worktree"、queue_state 和 idempotent_replay。这只是成功持久化占位任务，不代表 Agent 已运行。
5. 启动阶段正常顺序是 preparing_worktree -> starting_agent -> running；路径冲突或容量限制可能让任务保持排队状态。
6. 启动后只做一次有界等待，不要高频轮询 get_task。
7. 从 detail_level="review" 的 Review Package 开始审查，再按风险最小化升级读取范围。
8. 只有 Codex 或用户验收后才执行 finish/merge/discard/delete。

同一幂等键和同一请求会返回原任务，并设置 idempotent_replay=true；同一键配不同参数会返回 IDEMPOTENCY_CONFLICT。遇到超时不得换新键创建“替代任务”。

max_rounds 的有效范围是 1-10，MCP Schema 上限固定为 10。

命令选择

MiMo 任务：

& $Client start --json .\task.json --idempotency-key "replace-with-one-stable-uuid"
& $Client wait --task-id task_xxx --timeout-seconds 1800
& $Client review --task-id task_xxx --detail-level review --max-chars 8000
& $Client recover --limit 5 --max-chars 8000

Reasonix 或通用 Agent 任务：