dsh-mcp-manager
DeepSeek Harness 的 MCP 服务管理器：装没装、连没连、一页管完。
设置 → MCP 管理 管理项目级与全局
无需再手改配置文件，所有修改即改即生效（HMR 热应用），重启、升级后依然存在。
服务器列表 新增 / 编辑 / 删除 启用 / 停用 重启 工具数健康 JSON 导出 / 导入4 个模型工具 HTTP API npx / npm / dsh plugin / 脚本设置 → MCP 管理 管理项目级与全局
cordis.patch.yml 中的 @deepseek-ai/dsh-mcp-client 行——无需再手改配置文件，所有修改即改即生效（HMR 热应用），重启、升级后依然存在。
[](https://www.npmjs.com/package/@xxxyz/dsh-mcp-manager)
[](https://raw.githubusercontent.com/xxxyz/DeepSeekHarness-MCP-Manager/main/LICENSE)
[](https://raw.githubusercontent.com/xxxyz/DeepSeekHarness-MCP-Manager/main/package.json)
[](https://github.com/xxxyz/DeepSeekHarness-MCP-Manager)
✨ 功能一览
- 📋 服务器列表：列出所有已配置的 MCP 服务器（
@deepseek-ai/dsh-mcp-client实例）——serverName、传输方式（stdio/streamable-http）、URL / 命令、启用状态、loader 实时加载阶段、已注册工具数 - ➕ 新增 / ➖ 删除：表单添加 MCP 服务器（支持 env / headers / args），带格式与重名校验；一键删除
- 🔌 启用 / 停用：随时切换，工具随之热连接 / 热断开
- 🔄 重启：disable + re-enable，自动重连并重新同步工具
- 💾 持久化：写入项目级（
profiles/<profile>/cordis.patch.yml）或全局（~/.dsh/cordis.patch.yml），重启后保留；页面底部显示文件路径 - 🩺 健康检查：每台服务器实时工具数与 loader 阶段，异常一目了然
- 📦 备份 / 恢复：JSON 导出 / 导入，合并新增、已存在自动跳过
- 🤖 模型工具：宿主注册 4 个
mcp_manager_*工具，模型可直接查询与操作 MCP 服务 - 🌐 HTTP API：
POST /dsh-mcp-manager/api（JSON{op, args}→{ok, ...}），供客户端与脚本调用 - 📦 跨平台安装：Windows / macOS / Linux 一条命令（npx / npm /
dsh plugin/ 脚本）
🚀 安装
前置：DSH 已装好（dsh web 能正常运行），Node.js ≥ 18。
方式一 · npx 一条命令（推荐）
npx -y @xxxyz/dsh-mcp-manager所有参数照常透传：npx -y @xxxyz/dsh-mcp-manager --dsh-home /path/.dsh --profile web --repair --port 3080。
方式二 · npm 全局安装（适合经常使用）
npm i -g @xxxyz/dsh-mcp-manager
dsh-mcp-manager # 安装插件
dsh-mcp-manager-uninstall # 卸载插件
npm i -g @xxxyz/dsh-mcp-manager@latest # 升级方式三 · dsh 命令安装（bundle 方式）
dsh plugin --profile web add @xxxyz/dsh-mcp-manager
# 或 GitHub 源（构建产物 lib/ 已入库，无需本地构建）
dsh plugin --profile web add github:xxxyz/DeepSeekHarness-MCP-Manager方式四 · 免 npm 账号：GitHub 直拉
npx -y github:xxxyz/DeepSeekHarness-MCP-Manager脚本安装（源码方式：下载仓库后执行，幂等）
**Windows（PowerShell）**： ```powershell .\dsh-mcp-manager\install.ps1 # 默认 ~/.dsh + web profile .\dsh-mcp-manager\install.ps1 -DshHome D:\path\.dsh -Profile web ``` **macOS / Linux（bash）**（无执行权限先 `chmod +x dsh-mcp-manager/install.sh`）： ```sh ./dsh-mcp-manager/install.sh # 默认 ~/.dsh + web profile ./dsh-mcp-manager/install.sh --dsh-home /path/.dsh --profile web ``` **任何平台直接运行**： ```sh node dsh-mcp-manager/install.mjs [--dsh-home装完硬刷新浏览器（Cmd/Ctrl+Shift+R），打开 设置 → MCP 管理 即可看到管理页。若未出现，重启一次 DSH（host 半首次挂载需要）。
卸载
```sh dsh-mcp-manager-uninstall # 若用 npm -g 安装 # 或：.\uninstall.ps1 | ./uninstall.sh | node uninstall.mjs [--dsh-homeDSH 升级后：--repair
DSH 升级（或 HMR 状态异常）后若 **设置里没有"MCP 管理"** 或 **`mcp_manager_*` 工具消失**，运行一次修复命令：重新部署 → 递增 loader 行 `config.version`（触发 HMR 重应用）→ 轮询 API 直到 `{ok:true}`（默认 30 秒）。 ```sh node dsh-mcp-manager/install.mjs --repair --port 3080 # PowerShell: .\install.ps1 -Repair -Port 3080 bash: ./install.sh --repair --port 3080 ``` 仍不恢复则重启一次 DSH（loader 启动时重新导入）。常见问题
| 现象 | 原因与解决 | |---|---| | 装完设置里没有"MCP 管理" | 硬刷新（Cmd/Ctrl+Shift+R）；仍没有就重启 DSH 一次。 | | 页面出现**两个 MCP 页签 / 工具重复** | 双挂载：同时用了 install.mjs 与 `dsh plugin add` 两种方式。卸载其中一种（`dsh-mcp-manager-uninstall` 或删掉对应的 loader 行 / `dsh.profile.bundles` 条目）。 | | DSH 升级后工具消失 | 跑一次 `--repair`（见上）。 | | `npx` / `npm view` 报 404 | 国内镜像（npmmirror）同步有延迟：加 `--registry=https://registry.npmjs.org` 或稍等再试。 | | 安装脚本报错 `EPERM` | DSH 正在运行占用了文件：先退出 DSH 再装。 | | 修改配置后未生效 | 所有修改走 HMR 热应用，等 1–2 秒自动刷新；页面会自动轮询。 |📖 使用说明
打开 设置 → MCP 管理：
- 添加服务器：填写
serverName（唯一，1–32 位[A-Za-z0-9_-]）、传输方式及对应字段（streamable-http填 URL / headers；stdio填 command / args / env），选择级别（项目级 / 全局）。面板做格式与重名校验。 - 每张卡片显示实时状态、连接目标与工具数；可 启用 / 停用、重启、编辑、删除。
- 备份 / 恢复：一键导出 JSON，或粘贴 JSON 导入（合并新增，已存在自动跳过）。
- 页面底部显示正在编辑的补丁文件路径。
⚙️ 配置
插件自身在 loader 行中的配置：
| 字段 | 说明 |
|---|---|
version |
loader 行 config.version。--repair 会将其递增以强制 HMR 重应用，无需手动修改。 |
loader 行必须为 insert 块形式（DSH patch 方言中普通 - id: 行只是对已存在条目的覆盖，无法新增插件）：
- insert:
- id: dsh-mcp-manager
name: dsh-mcp-manager
config:
version: 1🏗️ 架构
- 宿主端（
src/index.ts→lib/index.js，对象形态 Cordis 插件{name, inject, apply}）：inject声明timer/fs/settings/sandboxPolicy/webServer/tools，框架保证就绪并在依赖消失时自动重载——这是插件跨 DSH 升级存活的机制。注册 4 个模型工具（ctx.tools.register(defineTool(...))）与精确路由POST /dsh-mcp-manager/api（ctx.effect作用域化清理）；对cordis.patch.yml做行级 CRUD（迷你 YAML 解析 + 按文件写锁）。 - 浏览器端（
lib/client.js，ModuleLoader CJS bundle）：注册 设置 → MCP 管理 页（settings.section槽位，order 16），经同源fetch('/dsh-mcp-manager/api')与宿主通信，不直接访问文件系统。 - loader 行：写入 profile 的
cordis.patch.yml，client-modules 服务扫描启用的条目并下发客户端 bundle。 - 安装器：
install.mjs（跨平台核心）/install.ps1/install.sh+ 对应的uninstall.*；npm 包@xxxyz/dsh-mcp-manager的 bin 直接执行安装器（dsh-mcp-manager/dsh-mcp-manager-uninstall）。
🛠️ 开发
npm install
npm run build # tsc -p tsconfig.json → lib/index.js（宿主端）- 宿主插件源码：
src/index.ts；浏览器 bundle：lib/client.js（手写，无需构建） - 包本身纯 JS、零依赖、跨平台；构建只需 devDependencies（typescript、
@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@types/node） - 发布：
npm version patch && npm publish（prepublishOnly自动构建；scoped 包已配置publishConfig.access: public）
许可证
MIT