dsh-mcp-status

English | 中文

DeepSeek Harness 的 MCP 连接面板插件。

它在对话输入框下方的工具栏里加一个按钮，列出本机所有 MCP 服务器，并逐个开关连接。 装了它之后，DSH 启动时不再连接任何 MCP 服务器。

为什么需要它

DSH 里每个 MCP 服务器都是一行 @deepseek-ai/dsh-mcp-client。这些行一旦启用，Loader 在启动时就会逐个拉起连接；连不上时 supervisor 进入重连退避（500ms → 30s，最多 10 次）， 于是后台每几十秒就重试一次。对不常用的服务器来说，这既拖慢启动，也一直在烧子进程和 连接尝试。

本插件把「要不要连」这件事从启动时挪到用户手上：行保留为纯配置，连接由面板按需建立。

安装

需要一个 web surface profile（dsh web 的默认 profile 名是 web）。git 和 pnpm 都要在 PATH 上。

# 从 GitHub 直装
dsh plugin --profile web add github:my-dsh/dsh-mcp-status

# 或安装已发布到 npm 的版本
dsh plugin --profile web add @my-dsh/dsh-mcp-status

包声明了 dsh.bundle，安装后自动加入 profile 的 bundle 层栈，重启 DSH 生效。

装完之后要做的一件事

把已有的 MCP 行关掉，让 disabled: true 写进 profile，这样下次启动才不会自动连。 在 GUI 里点一下对应的开关即可（关闭会写回 profile），或者直接改 ~/.dsh/profiles/<name>/cordis.patch.yml：

- id: mcp-chrome
  disabled: true
- id: mcp-mysql
  disabled: true

界面

位置在输入框下方那行工具栏：和「+」号、「工作区内修改」在同一个 flex 容器（.tools）里， 紧挨「工作区内修改」右侧。

• 按钮显示 MCP 2/3 已连接，左侧圆点表示是否有连接（有连接=绿色，读取失败=红色）。
• 点开是一个面板，每个服务器一行：名称、传输方式、连接目标、工具数、连接状态、开关。
• 面板打开时每 4 秒刷新一次；关闭时不发请求。
• 尺寸与相邻 chip 一致：高 28px、radius-sm、13px/20px、同样的 hover 底色。
• 中英文案跟随界面语言。

它是怎么工作的

行是纯配置。 每个 @deepseek-ai/dsh-mcp-client 行继续作为服务器配置的唯一来源 （transport / command / args / env / url），但被置为 disabled: true，Loader 不再挂载它们， 所以启动时零连接、零重连计时器。

连接由面板接管。 打开开关时，插件用该行的配置在自己的 context 里挂载官方 dsh-mcp-client 插件，工具与资源照旧注册到 ctx.tools；关闭开关时 dispose 掉那个挂载， 传输关闭、工具注销。连接的生命周期就等于用户开着它的时间，重启后一定是断开状态。

一条兼容路径。 如果某个行在 profile 里仍是启用状态，面板会如实显示为「已连接（由该行 自己维护）」，此时关闭开关会走 Plugin Manager 把 disabled: true 持久化——这样开关的含义 始终一致：关掉就是重启后也不会自动连。

Host 路由

两条都在需要认证的 /api 通道上，客户端用同源 fetch('api/...') 调用。

• GET api/mcp-status.list → { servers: [{ entryId, serverName, transport, target, enabled, connected, phase, tools, editable }] }
• POST api/mcp-status.set { entryId, enabled } → { ok, application, status }； 连不上时 { ok: false, reason: 'connect-failed', diagnostic }

配置

cordis.patch.yml 里的行可以带可选配置，通过用户 patch 层覆盖：

- id: mcp-status
  name: '@my-dsh/dsh-mcp-status'
  config:
    # 单次连接的等待上限毫秒（默认 8000）。超时后面板显示「连接中」并继续等，
    # 不会把还在连的服务器判成失败。
    connectTimeoutMs: 8000

依赖

运行时不 import 任何第三方包：MCP 插件通过 ctx.loader.import('@deepseek-ai/dsh-mcp-client') 从 Loader 取，所以这个 bundle 不需要 声明 dependencies。Host 半只用 Node 内置模块。

Client 半是纯 JavaScript（React.createElement，无构建步骤），只 require 平台模块表里的 react 和 react-dom。

源码布局

dsh-mcp-status/
├── index.js            # Host 半：读 MCP 行、挂载/卸载连接、两条 /api 路由
├── client.js           # Client 半：工具栏按钮与面板
├── cordis.patch.yml    # bundle 补丁：插入 mcp-status 行
├── locale/
│   ├── zh.json         # 插件列表里的标题与描述
│   └── en.json
├── icon.svg            # 插件图标
└── package.json        # dsh.bundle + dsh.client 声明

发布到 npm

需要一个能写 @my-dsh scope 的 npm 账号。package.json 里已设好 publishConfig.access: public，维护者执行：

npm login                       # 用 @my-dsh scope 对应的账号
npm publish

仓库根的 .npmrc 把 registry 钉在 https://registry.npmjs.org/，发布机器无需手工切换。 npm pack --dry-run 可预览实际 tarball 内容。

License

MIT