@deepseek-ai/dsh-mcp-client streamable-http transport never connects when activated as a plugin entry (fiber shows ACTIVE, zero TCP connections, silent failure; failOnStartupError: true ineffective)

[xielforever]

Bug Report: dsh-mcp-client streamable-http transport hangs during plugin activation (no TCP connection, silent failure)

---

标题（Title）

@deepseek-ai/dsh-mcp-client streamable-http transport never connects when activated as a plugin entry (fiber shows ACTIVE, zero TCP connections, no error surfaced; failOnStartupError: true does not help)

环境（Environment）

项	值
dsh	0.1.0-rc.6（npm 全局安装，web profile）
dsh-mcp-client	0.1.0-rc.6
@modelcontextprotocol/sdk	1.30.0（dsh 的依赖，^1.12.0）
Node.js	v24.13.0
平台	Windows 11 (Win32), PowerShell 5.1
profile	web（bundles: @deepseek-ai/dsh-base + @deepseek-ai/dsh-web-app）

描述（Description）

在 web profile 的 cordis.patch.yml 中用 streamable-http 传输注册一个 MCP server 后，dsh 启动正常、插件条目 fiber 状态变为 ACTIVE，但客户端从未向 MCP 端点发起任何 TCP 连接（Get-NetTCPConnection / netstat 高频监控均无痕迹），工具也从未注册。整个过程无任何错误输出——即使设置 failOnStartupError: true 也不会报错（启动照常成功），问题被完全静默吞掉。

复现步骤（Steps to Reproduce）

1. 在 ~/.dsh/profiles/web/cordis.patch.yml 添加（insert 语法）：

- insert:
    - id: mcp-test
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: test
        transport: streamable-http
        url: http://<host>:<port>/mcp
        headers:
          Authorization: 'Bearer <token>'
        failOnStartupError: true

2. 启动：dsh --profile web --port 0（MCP 端点为可达的 HTTP 服务，curl / 独立 SDK 脚本均可正常连接）。
3. 观察：
   • 启动成功，无任何报错（即使 failOnStartupError: true）；
   • Get-NetTCPConnection -RemotePort <port> 持续为空（60 秒高频监控，包括 SYN_SENT/TIME_WAIT）；
   • 新会话工具列表中无 mcp__test__* 工具。

期望行为（Expected）

• 插件激活时应建立到 MCP 端点的连接、listTools() 同步工具并以 mcp__<serverName>__<name> 注册；连接失败时应记录日志并在 failOnStartupError: true 时阻止启动。

实际行为（Actual）

• 插件条目在 loader 树中存在（ctx.loader.entries() 可见），fiber 状态为 ACTIVE(2)；
• 零 TCP 连接（netstat / PowerShell 双重确认，60 秒每 5 秒采样）；
• 无任何错误/警告日志（测试确认 dsh 的 ctx.logger.warn/error 不输出到 stdout/stderr，失败完全静默）；
• failOnStartupError: true 不生效（不报错、不阻止启动）；
• 工具未注册（ctx.tools.layers.global.tools.data 为空）。

排查证据（已排除配置/网络/服务器问题）

以下对照实验在**同一台机器、同一个 MCP 端点（可达、鉴权有效）**下进行：

#	实验	结果
1	独立 Node 进程：MCP SDK Client + StreamableHTTPClientTransport 直连	✅ 成功（CONNECTED，listTools 返回 15 个工具）
2	dsh 运行时内（自定义 probe 插件，setTimeout 回调中）裸 fetch 端点	✅ HTTP 200
3	dsh 运行时内（probe 插件）SDK 直连（含 { capabilities: {} }、onclose、setNotificationHandler 精确复刻 dsh-mcp-client 的调用方式）	✅ 成功（CONNECTED + 15 tools）
4	dsh 运行时内，用 ctx.loader.entries() 读出的完全相同 config（url + headers 与 YAML 解析一致）SDK 直连	✅ 成功（CONNECTED + 15 tools）
5	同一插件配置，transport: stdio（本地 stdio server / bridge）	✅ 正常（连接、同步、注册全部成功）
6	同一插件配置，streamable-http 指向本地不可达端口	✅ 立即报 ECONNREFUSED（说明 connect 机制与错误路径本身可用）
7	同一插件配置，streamable-http 指向可达远程端点	❌ 挂起：fiber=ACTIVE、零 TCP 连接、无报错

结论：配置语法、token、网络、MCP 服务器、SDK 本身均正常；问题特定于 dsh-mcp-client 插件实例在激活流程中以 streamable-http 连接远程端点的场景。

疑似根因（Hypothesis）

1. apply 的异步结果不被 Cordis 等待：dsh-mcp-client/lib/index.js 中 apply 为 async，注释明确说明 “Cordis treats a prototype-bearing ordinary function as a constructor, whose returned Promise is not startup work”。因此 await connection.ready 挂起时，fiber 仍被标记为 ACTIVE，错误与挂起状态对外不可见。
2. 连接在激活上下文中未发出：对照实验 2/3/4（非激活上下文，setTimeout 回调）成功，实验 7（激活上下文）零 TCP 连接——疑似 Cordis fiber 激活的 async context 与 MCP SDK / undici fetch 的交互问题，导致请求在发出前挂起。
3. ctx.logger 输出不可见：ctx.logger.warn/error（如 connection attempt failed、giving up after N attempts）不输出到 stdout/stderr，使故障完全静默，难以排查。

影响（Impact）

• 通过 streamable-http 接入任何远程 MCP server 均静默失败，用户无法感知；
• 临时规避方案：使用 stdio transport + 本地桥接脚本转发到 HTTP 端点（已验证可行）。

建议（Suggested Fix）

1. 激活流程中 await apply 返回的 Promise（或显式区分构造函数/异步 apply），使挂起/失败能反映到 fiber 状态（如 LOADING/FAILED）；
2. 让 failOnStartupError 覆盖“连接挂起/超时”场景（增加连接超时，如复用 SDK 的 60s 默认或暴露 connectTimeoutMs 配置）；
3. 调查 streamable-http 在激活 async context 中不发起 TCP 连接的问题（与实验 2/3/4 的差异）；
4. ctx.logger 至少应输出到 stdout/stderr 或提供可配置的日志出口。

附加信息

• 复现用的最小 patch 文件、probe 插件脚本与观测方法（netstat / Get-NetTCPConnection / fiber 状态读取）可提供。
• 端点信息可脱敏后提供（内网 HTTP 服务，MCP 协议 2025-03-26，鉴权 Bearer）。

[bobleer]

我这边做了个反向的：deepseek-harness-plugin-mcp，一个 MCP server 让任意 agent 装/跑 dsh 插件，支持 stdio 和 streamable http（--http --port）。github.com/bobleer/deepseek-harness-plugin-mcp，MIT，欢迎共建。

[weijiafu14]

这个 dsh-mcp-client 激活挂起问题本身仍然属于官方 MCP client 的缺陷；但如果当前目标是先让远程 Streamable HTTP MCP 真正连通，可以换一条已经端到端验证过的运行时：

dsh plugin --profile web add pi2dsh pi-mcp-adapter

重启后由原 pi-mcp-adapter 自己负责 Streamable HTTP/SSE transport、连接生命周期、工具同步和重连，pi2dsh 只把工具、命令、问答和附件投影进 DSH。我们已经在 stock DSH 上跑过真实 Streamable HTTP server、动态工具注册和模型工具回合；Atlassian Remote MCP 的 OAuth/DCR/PKCE/刷新链也完整通过。

如果希望连管理界面一起装，可以直接使用组合套件：

dsh plugin --profile web add dsh-work-x dsh-better-sidebar

这是一条可立即使用的替代 MCP runtime，不代表你报告的 native dsh-mcp-client 激活/fiber/failOnStartupError 问题已经修复。复现与边界：https://github.com/weijiafu14/pi2dsh/blob/main/docs/mcp-compatibility.md