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

dsh-mcp-manager for DSH

一个 DeepSeek Harness 插件包，管理注册在 DSH 补丁文件里的 MCP 服务器：列出、真实握手探测、从粘贴的项目引用添加、启用/禁用、移除、凭据轮换——遵循官方 @deepseek-ai/dsh-mcp-client 配置契约。

安装

方式 A —— 智能体工具（Creator 模式）： 对你的智能体说：

plugin_manager install_bundle https://github.com/<owner>/dsh-mcp

方式 B —— Web UI： 打开 DSH Web 应用侧边栏的 Plugins 页面，从上面的 GitHub URL 安装。

两个官方渠道都会运行 pnpm、校验插件包清单、自动选中插件包。安装完成后，智能体可以使用七个工具：

| 工具 | 用途 |
| mcp_manager_list | 列出已注册的 MCP 服务器（凭据值已打码） |
| mcp_manager_probe | 对单个或全部服务器做真实 MCP 握手（initialize + tools/list） |
| mcp_manager_add | 粘贴 npm 包 / GitHub 仓库 URL / MCP 端点 URL / JSON 配置；默认 dry-run，confirm: true 才写入 |
| mcp_manager_remove | 移除条目（必须 confirm: true） |
| mcp_manager_toggle | 启用/禁用条目（必须 confirm: true） |
| mcp_manager_credential | 定位 / 打码显示 / 轮换 !!js 引用的凭据文件 |
| mcp_manager_validate | 按官方 mcp-client 规则检查条目 |

安装后验证：工具调用返回 application: applied；然后调用 mcp_manager_list——应该能看到你的服务器（chrome-devtools、playwright、github……）。在新会话里，工具会变成 mcp__<serverName>__<tool>。

命令行

插件包还附带一个零依赖命令行（同一套引擎，不需要 harness）：

node cli/mcp.js list [--json]
node cli/mcp.js probe [--id <id>] [--timeout 60]
node cli/mcp.js add "<npm-package | github-url | mcp-url | json>" [--yes] [--no-probe]
node cli/mcp.js enable|disable <id> --yes
node cli/mcp.js remove <id> --yes
node cli/mcp.js credential <id> get|set <value>
node cli/mcp.js validate <id>
node cli/mcp.js schema

所有写入都走同一条受保护的流水线：在候选副本上做手术 → 用 DSH 自己的加载器（loadOptionalPatches）校验 → 原子写入并生成 .bak 备份。校验失败的候选内容永远不会碰到你的线上补丁。

写入内容

条目严格遵循官方 @deepseek-ai/dsh-mcp-client 契约：

- id: mcp-<serverName>
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: <serverName> # [A-Za-z0-9_-]{1,32}, unique
transport: stdio # or streamable-http
command: npx # stdio only
args: ['-y', '<package>']
failOnStartupError: true # recommended for fresh entries

密钥永远不会写进补丁：工具把密钥存到凭据文件，再用 !!js 表达式引用（和官方 GitHub 条目会用到）。DSH 会热重载补丁——新服务器无需重启即可出现。

范围与安全

- 写入目标是 home 覆盖层 ~/.dsh/cordis.patch.yml（官方组合顺序：bundle 补丁 → profile 补丁 → home 补丁 → --patch）。
- 每次改动都需要显式确认（confirm: true / --yes）；删除和切换会保留上一份文件的 .bak。
- 探测是只读的；它们绝不会启动浏览器，也不会把凭据发到服务器自身端点以外的任何地方。

开发

node --test "test/*.test.mjs" # 58 tests, zero dependencies
node -e "import('./scripts/check-bundle.mjs').then(m => console.log(m.checkBundle('.')))"

官方规则以 vendor 形式放在 docs/official/ 下（从已安装的 DSH app.asar 中提取；来源说明见 docs/official/README.md），设计与方案放在 docs/ 下。