MCP 连接管理 penglai-doll/dsh-mcp-manager

dsh-mcp-manager

中英双语：英文在前，中文译文在后。

正式（组合挂载）的 DeepSeek Harness 插件：在 Web 插件设置区新增 MCP 管理 标签页，用来管理 MCP 服务器连接。

管理哪些内容

DSH 里的 MCP 服务器是随附 @deepseek-ai/dsh-mcp-client 桥接器的组合行：一行连接一个 MCP 服务器（stdio 子进程或 Streamable HTTP 端点），并把它的工具注册为 mcp__<serverName>__<toolName>。本插件编辑当前配置档 cordis.patch.yml 中的这些行：

- 列出所有 MCP 行，显示传输方式、启用状态、Loader 实时阶段（pending/loading/active/failed），以及每个服务器当前注册的 mcp__ 工具。
- 添加 / 编辑行，表单包含：传输方式、serverName、command/args/env/cwd（stdio）或 url/headers（streamable-http）、工具调用超时、启动错误策略、重连策略。形如 process.env.X 的 env/header 值会写成 !!js loader 表达式。
- 启用 / 禁用 / 删除行，按行操作；每次写入都会在文件旁留下 cordis.patch.yml.bak 备份。
- 校验规则与 @deepseek-ai/dsh-mcp-client 的 schema 一致：serverName 为 [A-Za-z0-9_-]{1,32} 且唯一，transport 为枚举值，command/url 必填，数值有范围限制。

架构

- lib/index.js —— 宿主端（纯 ESM）：注入 webServer、fs、loader、tools；通过 webServer.register 在 /mcp-manager/ 下提供同源 JSON API（包在 ctx.effect 里，所以拆除时会移除路由）。它用一个小型 YAML 子集解析器解析并拼接补丁文件，绝不重写不属于自己的行。
- lib/client.js —— 客户端：手写的 Web 插件包，采用 window.__ModuleLoader__.load({id, factory}) 格式；注册 settings.plugins.tab（id 为 mcp），用 fetch 调用宿主 API。唯一的模块依赖：react。

定位补丁文件

宿主端扫描 $DSH_HOME/profiles//cordis.patch.yml，编辑挂载了本插件的配置档（包含 id: mcp-manager 的行）。单配置档部署没有歧义。覆盖方式：

- DSH_MCP_MANAGER_PATCH —— 直接指定要编辑的 cordis.patch.yml 路径。
- DSH_PROFILE —— 多个配置档都挂载本插件时，用它消除歧义。

生效时机

Web 配置档默认禁用 hmr 行，所以编辑要等下次 dsh web 重启才生效。启用 HMR 后（取决于部署选择），Loader 会热应用补丁编辑，mcp-client 行无需重启即可断开/重连。

安装（Web 配置档）

dsh plugin --profile web add <this-directory>

并在配置档的 cordis.patch.yml 中添加一行：

- insert:
- id: mcp-manager
name: 'dsh-mcp-manager'
然后重启 dsh web。这一行既是 host 行，也（通过 package.json 里的 dsh.client 字段）是浏览器 roster 行。

后续若修改本包源码，重新执行 add 命令（或把目录重拷到 <profile>/node_modules/）并重启。

信任

/mcp-manager 路由执行的变更是用户手改 cordis.patch.yml 本就能做的，且与 Web UI 同源同端口、无额外鉴权。请仅在 loopback 主机上使用本插件。

正式（composition 挂载）的 DeepSeek Harness 插件：Web 插件设置里的一个 MCP 管理 标签页，管理 MCP 服务器连接。

它管理什么

DSH 里的 MCP 服务器是随附 @deepseek-ai/dsh-mcp-client 桥接的组合行：一行连接一个 MCP 服务器（stdio 子进程或 Streamable HTTP 端点），并把其工具注册为 mcp__<serverName>__<toolName>。本插件在活动 profile 的 cordis.patch.yml 里编辑这些行：

- 列出每个 MCP 行：传输方式、启用状态、实时 Loader 阶段（pending/loading/active/failed），以及每个服务器当前注册的 mcp__ 工具。
- 新增 / 编辑行（表单）：transport、serverName、command/args/env/cwd（stdio）或 url/headers（streamable-http）、工具调用超时、启动错误策略、重连策略。形如 process.env.X 的 env/header 值会被输出为 !!js loader 表达式。
- 启用 / 禁用 / 删除行（行级手术）；每次写入都在文件旁留一份 cordis.patch.yml.bak 备份。
- 校验镜像 @deepseek-ai/dsh-mcp-client 的 schema：serverName [A-Za-z0-9_-]{1,32} 且唯一、transport 枚举、command/url 必填、数值范围。

架构

- lib/index.js — Host 半边（纯 ESM）：注入 webServer、fs、loader、tools；通过 webServer.register 提供 /mcp-manager/ 同源 JSON API（包在 ctx.effect 里，卸载即移除路由）。它用一个 YAML 子集解析器解析并拼接补丁文件，绝不重写不属于自己的行。
- lib/client.js — Client 半边：window.__ModuleLoader__.load({id, factory}) 格式的手写 web 插件 bundle；注册 settings.plugins.tab（id mcp），用 fetch 调用 host API。唯一模块依赖：react。

定位补丁文件

Host 半边扫描 $DSH_HOME/profiles//cordis.patch.yml，并编辑挂载本插件的那个 profile（含 id: mcp-manager 行）。单 profile 部署不会歧义。覆盖项：

- DSH_MCP_MANAGER_PATCH — 直接编辑指定的 cordis.patch.yml 路径。
- DSH_PROFILE — 多个 profile 挂载本插件时消歧。

生效时机

Web profile 默认禁用 hmr 行，因此编辑在下次 dsh web 重启后生效。启用 HMR（部署选择）时，Loader 会热应用补丁编辑，mcp-client 行无需重启即断开/重连。

安装（web profile）

dsh plugin --profile web add <this-directory>

并向 profile 的 cordis.patch.yml 加一行：

- insert:
- id: mcp-manager
name: 'dsh-mcp-manager'

然后重启 dsh web。该行既是 host 行，也（通过 package.json 里的 dsh.client 字段）是浏览器 roster 行。

后续若修改本包源码，重新执行 add 命令（或把目录重拷到 <profile>/node_modules/）并重启。

信任

/mcp-manager 路由执行的变更是用户手改 cordis.patch.yml 本就能做的，且与 Web UI 同源同端口、无额外鉴权。请仅在 loopback 主机上使用本插件。