前言¶
在 DeepSeek Harness（DSH）里调试 Model Context Protocol（MCP）服务时，经常需要知道：当前 profile 有多少 MCP 服务器、它们实际注册了多少工具、配置改完是否生效。社区现有的管理面板大多只是对 cordis.patch.yml 做增删改，却拿不到这些实际运行状态。sunt2049/dsh-mcp-manager 把这些数据接了起来，在设置页里提供可视化的总览与控制。
它是什么¶
sunt2049/dsh-mcp-manager 是 DeepSeek Harness 的一个客户端插件，维护者为 sunt2049。它为当前 profile 提供一个 MCP 控制台：可以查看所有 MCP 服务器的状态、实时工具清单与完整 JSON Schema、进行连通性探测，以及添加/删除/停用/启用服务器、编辑配置。
核心功能¶
服务器总览¶
- 显示每个 MCP 服务器的传输方式（SSE/stdio）
- 端点地址或命令行参数
- 已注册的工具数量
- 环境变量与请求头的键名（值不回显）
- 超时设置
工具清单 + JSON Schema¶
- 按服务器分组展示工具列表
- 支持搜索过滤
- 点「参数」查看每个工具的完整 JSON Schema，并支持复制
连通性探测¶
- 区分「端口不通」「端口通了但 MCP 握手失败」「握手成功」
- 对 stdio 类型，检查
command与参数中的绝对路径是否存在
配置维护¶
- 添加 / 删除 / 停用 / 启用 MCP 服务器
- 直接维护 profile 的
cordis.patch.yml - 停用记录按 profile 分文件存储在
profiles/<profile>/mcp-manager/disabled.json - 停用可恢复：摘掉的行原样暂存，启用时按原位置插回
- 只有本 profile 的
cordis.patch.yml里的行能删除；来自其它层（例如 agent preset、其它 patch 文件）的行会标注并禁用
编辑配置¶
- 可编辑 url / command / args / 超时 / failOnStartupError
- 编辑是即时生效的，因为走
ctx.configEditor.edit，MCP 客户端会就地重载该连接
写入边界¶
- 使用块级解析器读写文档，注释、空行、以及不属于 MCP 的行一律原样保留
- 解析结果无法逐字节还原时直接拒绝写入，不会“尽力而为”地重排配置
安装与启用¶
从 npm 安装：
dsh plugin --profile web add @sunt2049/dsh-mcp-manager
从 Git 仓库安装：
dsh plugin --profile web add github:<owner>/<repo>
安装后重启一次 DSH，在 设置 → MCP 控制台 里使用。
典型用法¶
- 安装插件后，在 DSH 设置页进入「MCP 控制台」
- 查看当前 profile 的所有 MCP 服务器及其状态、工具数量
- 点击某个服务器，查看其已注册的工具列表，点击「参数」查看完整 JSON Schema
- 点击「连通性探测」确认连接状态
- 若需调整配置，可直接在面板中编辑 url / command / args / 超时 / failOnStartupError，改动会即时生效
- 若需停用某服务器，点击「停用」，该行会从配置中摘除并暂存；再次点击「启用」会按原位置恢复
适用场景与注意¶
- 适合需要在 DSH 中集中管理多个 MCP 服务器的场景
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证
- 需要确保 DSH 版本不低于
0.2.0-rc.2（peerDependencies 由宿主做兼容性检查）
结语¶
sunt2049/dsh-mcp-manager 让 MCP 的状态可见、可测、可改。通过真实的工具注册数、完整的 JSON Schema 和连通性探测，配合即时生效的配置编辑，它解决了社区面板“只改壳子”的痛点。更多信息可在 GitHub 仓库查看。
