前言¶
在 DSH（DeepSeek Harness）里维护 MCP 服务器时，常见问题不只是“有没有连上”，还有工具数是否正常、不同 profile 的状态是否一致。只看单个 profile，或手动翻配置，容易漏掉未连接的服务器。
dsh-mcp-admin 是一个 DSH 插件，用来查看 MCP 状态，并在设置页里按 profile 管理 MCP 服务器。
这是什么¶
dsh-mcp-admin 由 kairoz9 维护，采用 MIT 许可。
它提供两个入口：
- /mcp 命令：列出 MCP 服务器和实时工具数。
- 设置页 MCP 面板：按 profile 管理 MCP 服务器。
保存操作会写回该 profile 的 cordis.patch.yml，随后触发 dsh 的热加载（HMR）。
核心功能¶
/mcp 命令¶
运行 /mcp 后，可以列出所有 profile 的 MCP 服务器，并看到实时工具数。列表包括从未连接的服务器。
设置页 MCP 面板¶
设置页的 MCP 面板支持按 profile 管理 MCP 服务器：
- 新增
- 编辑
- 禁用
- 启用
- 删除
状态点每秒自动刷新。保存后，配置会写回该 profile 的 cordis.patch.yml，dsh 会自动执行 HMR。
安装与启用¶
下面命令将插件安装到 web profile：
dsh plugin --profile web add github:kairoz9/dsh-mcp-admin
README 建议固定到 commit 或 tag，例如：
dsh plugin --profile web add github:kairoz9/dsh-mcp-admin#v0.2.0
如果使用 pnpm >=10 从 Git 安装失败，需要注意：pnpm >=10 默认会拒绝运行 Git 依赖的 prepare 脚本，这可能导致首次 Git 安装失败。可以在该 profile 的 pnpm-workspace.yaml 中加入：
allowBuilds:
dsh-mcp-admin: true
然后重新运行 add 命令。
典型用法¶
1、查看 MCP 状态
运行：
/mcp
命令会列出所有 profile 的 MCP 服务器，并显示实时工具数。从未连接的服务器也会出现在列表中。
2、管理某个 profile 的 MCP 服务器
进入设置页的 MCP 面板，选择目标 profile，然后执行新增、编辑、禁用、启用或删除。
3、保存并生效
保存会写回该 profile 的 cordis.patch.yml。dsh 随后会自动热加载（HMR）。
适用场景与注意¶
适合在多个 DSH profile 中维护 MCP 服务器，希望直接查看状态并调整配置的使用者。
注意：
- 插件以当前 dsh 进程权限运行。安装前应检查源码与 MIT 许可证。
- 保存会写回 cordis.patch.yml，属于 profile 配置变更。
- pnpm >=10 下从 Git 安装可能失败，需要添加 allowBuilds 后重试。
结尾¶
dsh-mcp-admin 将 /mcp 状态查看和设置页 MCP 管理结合在一起，适合需要经常调整 MCP 服务器配置、并希望在 DSH 内直接完成查看与保存的开发者。
