[Upstream Issue] dsh-mcp-client 不发送 MCP roots / rootUri，codegraph MCP 默认项目指向宿主启动目录而非当前工作区

[lifangjin]

环境

• DSH（@deepseek-ai/dsh v0.1.0-rc.7），dsh-mcp-client 插件（@deepseek-ai/dsh-mcp-client/lib/index.js）
• CodeGraph MCP server v1.5.0（stdio transport，codegraph serve --mcp）
• macOS，单 DSH 实例 + 多工作区（workspace）工作流

现象

在一个 DSH 实例内切换工作区时，codegraph_explore 等工具的默认项目始终指向 DSH 宿主进程的启动目录，而不是当前会话的工作区。

实测：DSH 宿主从 ~/Documents/code/DataNex/scripts 启动（工作区为 ~/Documents/code/private-aiagentos），codegraph MCP 默认项目解析到 DataNex（Rust 项目），本项目的 .codegraph/ 索引只有显式传 projectPath 时才会被打开。

根因（源码证据）

1. dsh-mcp-client 建立连接时不声明任何 MCP capabilities，也不发送 workspace 信息：

const generation = new Client({
  name: "dsh-mcp-client",
  version: "0.0.1"
}, { capabilities: {} });   // ← 空 capabilities，不声明 roots

• 不发送 rootUri / workspaceFolders（initialize 参数）
• 不声明 capabilities.roots，因此 codegraph 不会发起 roots/list
• 唯一传给子进程的路径是 transport 的 cwd（config.cwd），即 DSH 宿主进程启动目录，与当前会话 workspace 无关

2. codegraph v1.5.0 的默认项目解析顺序（mcp/session.js handleInitialize + resolveRoot）：

1. 客户端 initialize 带 rootUri → 用 fileUriToPath(rootUri)
2. 客户端 initialize 带 workspaceFolders[0].uri → 用之
3. 服务器启动参数 --path
4. 客户端声明 capabilities.roots → 启动后 roots/list 拉取第一个 root
5. 以上全部缺失 → 兜底 process.cwd() 向上找最近的 .codegraph/（findNearestCodeGraphRoot）

DSH 对 1/2/4 全部不提供（3 也由配置决定），于是永远走到第 5 条 = 宿主启动目录。

影响

• 多工作区单实例是 DSH 的正常用法，但 codegraph 默认项目被"钉死"在启动目录，无法跟随当前工作区；
• 依赖默认项目的 agent 规则（如本项目 AGENTS.md 的 codegraph-first 约定）在 DSH 下会静默查错项目；
• 只能靠每次调用显式传 projectPath 绕开，agent 工作流容易漏传。

期望行为

codegraph 默认项目应跟随 DSH 的当前会话 workspace：

• 方案 A（推荐）：dsh-mcp-client 声明 capabilities: { roots: { listChanged: false } }，并实现 roots/list 处理器返回当前 workspace root（file:// URI）；codegraph 侧已原生支持（clientSupportsRoots → roots/list 优先于 cwd）。
• 方案 B：连接时把当前 workspace 作为 rootUri 发送（LSP 风格，codegraph 最高优先级）。
• 方案 C：至少支持按会话/连接粒度注入 --path。

复现步骤

1. 在项目 A 目录启动 DSH（cd A && dsh web），工作区切换到项目 B；
2. 调用 codegraph_explore（不传 projectPath）；
3. 观察返回的源码来自项目 A 而非项目 B；
4. lsof -p <codegraph-mcp-pid> | grep cwd 确认其 cwd = 项目 A。

建议

在 dsh-mcp-client 中补充 MCP workspace 集成：声明 roots capability 并响应 roots/list（返回当前 ctx.sessions workspace 根），使 DSH 的 workspace 概念贯通到 MCP 层。codegraph 端无需改动。

相关文件

• DSH：@deepseek-ai/dsh-mcp-client/lib/index.js（new Client(..., { capabilities: {} })、StdioClientTransport({ cwd })）
• CodeGraph v1.5.0：lib/dist/mcp/session.js（handleInitialize rootUri/workspaceFolders/--path 分支、roots/list、cwd 兜底）、lib/dist/mcp/directory.js（findNearestCodeGraphRoot）

[weijiafu14]

你这份定位是对的（空 capabilities、不发 rootUri/workspaceFolders、子进程只拿到 transport 的 cwd）。先说一件能帮你省时间的事：换 MCP 客户端解决不了 roots。

我维护一个跑 Pi 生态 MCP 适配器的桥，为此对着上游做过一份兼容矩阵。里面明确记着一条已知差异：pi-mcp-adapter 的 adapter 级 roots 支持在上游本身就没实现。 所以如果有人建议你"换个 MCP 客户端就有 roots 了"，那是错的——两边在这一点上是一样的，我把它写在这里免得你白折腾一圈。

今天真正能让 codegraph 指对项目的，是绕开 roots 这一步——你自己列的解析顺序里第 3 步就是出路：

3. 服务器启动参数 --path

也就是按工作区配一个 server 实例，把项目路径显式写进启动参数：

- id: codegraph-projectA
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: codegraph
    transport: stdio
    command: codegraph
    args: ['serve', '--mcp', '--path', '/Users/你/Documents/code/private-aiagentos']

配合项目级配置分层（把这段放在项目自己的配置里而不是用户级），每个工作区起自己的那一份，路径就跟着工作区走了。这不优雅，但它绕开的正是缺失的那个握手。

（顺带：config.cwd 也可以显式设成工作区路径，那样第 5 步的兜底 process.cwd() 也会落对；但显式传 --path 比依赖兜底可靠。）

边界说清楚：

• 上面是 workaround，不是修复。你要的 roots / rootUri 握手仍然缺，而且是两个 MCP 客户端实现都缺——这条该由官方补 capabilities.roots + 在 initialize 里带工作区，我们改不了 dsh-mcp-client。
• 一实例多工作区的场景下，上面这条要给每个工作区各配一份，工作区一多就很烦。这正说明 roots 该被支持。

你这个 upstream issue 我认为提得很准，尤其是把 codegraph 的五步解析顺序列出来——它同时证明了"缺哪一步"和"从哪一步能绕"。

利益相关：我维护 pi2dsh，pi-mcp-adapter 不是我的包；上面给的方案用的是官方 dsh-mcp-client，不需要装我的任何东西。

[lifangjin]

我现在的做法是在我自己写的agent的提示词里加了一段内容用来提示使用codegraph的mcp工具必须使用当前目录：

Codegraph MCP default project may be a DIFFERENT repository than {{cwd}}. Never call codegraph_* tools without passing projectPath = {{cwd}} (the absolute path of your working directory). If {{cwd}} has no .codegraph index, fall back to glob/grep/read directly and do not loop or comment on project mismatches.

[PerryLink]

确认了：dsh-mcp-client 目前完全不发送 MCP roots。我在 packages/mcp/mcp-client/src/ 全量搜了 roots / rootUri / workspace，零命中；连接配置（index.ts:113-134）只有 stdio 的 command/args/env/cwd/reconnect 与 HTTP 的 url/headers/reconnect —— 没有 roots 能力声明，initialize 自然不会携带。你的报告成立：这是上游尚未实现的能力（截至 0.1.5-rc.2 核对）。

两个务实绕法

1. 单工作区：给 MCP server 配 cwd

stdio 配置里有 cwd 字段（index.ts:120，默认 ''）。codegraph 的默认项目就是它自己进程的启动目录 —— 把该 MCP server 配置的 cwd 指到你的项目目录（字段名就叫 cwd，位置在你现有的 stdio 配置块里），codegraph_explore 的默认项目就对了。注意默认 '' 意味着继承宿主进程 cwd，这正是你观察到「默认项目 = DSH 启动目录」的来源。

2. 多工作区：如果 codegraph 的工具 schema 支持项目参数，调用时显式带上；否则目前只能接受「切换工作区要重启 MCP server」。多工作区场景本质需要 roots 支持，绕法救不了。

关于让上游支持

MCP 规范里 roots 是 client capability，且工作区切换时客户端要发 roots/list_changed 通知 —— 这必须由 DSH 侧实现，插件补不了。这个仓只开 Discussions，正确位置是发一条 feature request 附上你这份实测（你的复现已经写得很完整，直接可用）。

（基于 0.1.5-rc.2 源码核对。）