MCP 服务器管理 097794/dsh-mcp-manager

dsh-mcp-manager

在 DeepSeek Harness（DSH）的 Web UI 里管理 MCP 服务器：

- 设置 → MCP 服务器：列出、添加、编辑、删除、启停和测试服务器。
- 输入框「+」菜单 → MCP 服务器：只对当前会话开关任意服务器。

每个配置的服务器都会作为一个真正的 @deepseek-ai/dsh-mcp-client 实例挂载，工具名（mcp__名称__工具）、资源和服务器说明与 profile 里手写的 MCP 行完全一致。

安装

需要带插件系统的 DSH 构建（如 DSH 0.2.1-rc.2 桌面版）。克隆/复制本目录后，通过 插件 → 添加插件 → 本地目录，或插件管理工具的 install_bundle 指向本目录安装。本地目录安装是软链，请保留该目录。

使用

服务器

| 字段 | 说明 |
| 名称 | 决定工具命名空间 mcp__名称__工具；字母、数字、_、-，最长 32。 |
| 传输 | stdio（本地进程）或 streamable-http（远程服务）。 |
| 命令 / 参数 / 工作目录 | 仅 stdio；参数每行一个。 |
| 环境变量 | 仅 stdio；每行 KEY=VALUE，值支持 ${ENV_VAR}。 |
| URL / 请求头 | 仅 streamable-http；请求头每行 Name: Value，支持 ${ENV_VAR}。 |
| 启用 | 关闭后不连接、不注册工具。 |

改动先进入草稿，点保存后下发；Host 会立即对齐：删除或修改的服务器断开，新增的服务器连接。

测试会在隔离作用域里临时挂载服务器，返回工具数量和名称，不影响正在使用的工具列表。${ENV_VAR} 从 Harness 进程环境展开，缺变量会直接报错。

已经写在 profile 里的 MCP 行（例如 mcp-anysearch）会以只读形式显示在「profile 中已有」，但同样受会话开关控制。

会话内开关

点输入框左边的 + 菜单（和 / 命令同一个菜单），选 MCP 服务器；原来弹出菜单的那个位置会直接换成 MCP 面板，每台服务器一行，显示工具数量和开关。

- 关闭 → 该服务器的工具对当前 Agent 隐藏（tools.restrict deny），mcp:<名称> 提示段也会从该会话的系统提示里移除；
- 开启 → 两者恢复。

点面板外面或按 Esc 关闭，行为和命令菜单一致。

状态作为会话级 plugin record（plugin:mcp-manager/toggles）持久化，换会话不串；子智能体默认全部开启。

实现要点

- Host 行持有 volatile 的 servers 配置；每个启用的服务器用 ctx.plugin(...) 挂一个 @deepseek-ai/dsh-mcp-client 子实例，连接生命周期由 Cordis 管理。
- system-prompt/assemble 过滤掉本会话关闭的 mcp:<名称> 段。
- agent/created、agent/disposed、tools/change 保持每个 Agent 的工具限制与开关同步。
- 浏览器半侧调用同源 JSON API（/dsh-mcp-manager/api/...）读取状态、测试连接、切换会话开关；管理页注册为 settings.section 页面（设置 → MCP 服务器），并贡献一个 /mcp 命令（动作是在 conversation.input.overlay——也就是 + 菜单所在的弹出层位置——打开会话面板）。

兼容性与风险

- 针对 DSH 0.2.1-rc.2 开发，依赖 ctx.plugin、tools.restrict、system-prompt/assemble、appendPluginRecord 等插件接口，不承诺跨版本兼容。
- stdio 服务器会用 Harness 进程的环境执行命令，只添加你信任的服务器。
- 工具隐藏只是会话级可见性，不是安全边界；删除服务器只断开连接，不清理它写入的数据。
- API 与 Web 服务同样只适合监听回环地址，不要暴露到局域网。

开发

node --test test/model.test.mjs

lib/model.js 是纯逻辑（配置规范化、${VAR} 展开、工具名映射、MCP 客户端配置构建），可以脱离 Harness 直接测试。

License

MIT。