ridge-mcp-dispatch

# Ridge 内置 MCP —— 终端内多 agent 调度 Ridge（桌面 app）与 `rdg`（无头 host）内建一个 **MCP server**，让运行在某个 pane 里的 你，去驱动**同一工作区其它 pane** 里的 teammate agent：拆分屏、派活、传数据、读上下文。 协议是 JSON-RPC 2.0 over WebSocket。 ## 1. 我在 Ridge 里吗？怎么连？ 只有当下面两个环境变量都存在时，本 MCP 才可用（Ridge PTY 注入，子进程继承）： ``` RIDGE_TEAMMATE_URL # 例 http://127.0.0.1:52731 —— HTTP base，端口是 ephemeral RIDGE_TEAMMATE_TOKEN # 鉴权 token RIDGE_WORKSPACE_ID # 发起方工作区 UUID（HTTP 放置路由需要，作 X-Ridge-Workspace 头） ``` **MCP WebSocket 端点** = `RIDGE_TEAMMATE_URL` 把 `http` 换成 `ws`，再接 `/api/v1/mcp/ws`： ``` ws://127.0.0.1:<port>/api/v1/mcp/ws ``` **鉴权**：升级请求带头 `x-ridge-token: <RIDGE_TEAMMATE_TOKEN>`（或 `Authorization: Bearer <token>`）。缺/错 → 401。 > 端点会漂移：后端 panic 自重启会换端口。env 里的值可能过期。权威副本落在 sidecar 文件 > `TMPDIR/ridge-teammate-endpoint-<sanitized>.json`（`{"url","token"}`），其中 `<sanitized>` = > `$TMUX` 第一段路径里非字母数字全替换成 `_`。连不上先读这个文件刷新 url/token。 ## 2. 协议方法（JSON-RPC 2.0） | method | 说明 | |---|---| | `initialize` | 握手，返回 serverInfo/capabilities。可选，直接调工具也行。 | | `tools/list` | 列出全部工具规格。 | | `tools/call` | `params: { "name": <tool>, "arguments": {...} }` 调工具。 | | `resources/read` | `params: { "uri": "ridge://..." }` 读资源。 | 请求形如 `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{...}}`；一发一收。 ## 3. 六个工具（`tools/call` 的 name） | name | arguments | 作用 / 语义 | |---|---|---| | `ridge_get_team_profile` | `{}` | **先调它**。返回花名册快照（每个 teammate pane 的身份、状态，同时给 `paneId`(UUID) 和 `paneIndex`(数字)）。派活前先发现目标。 | | `ridge_split_pane` | `{direction:"horizontal"\|"vertical", ro...