前言¶

DeepSeek Harness（DSH）通过 @deepseek-ai/dsh-mcp-client 接入 MCP 服务器，配置通常写在 profile 的 cordis.patch.yml 里。条目一多，要确认「装没装、连没连、启没启」往往得翻 YAML、重启或靠日志排查，改错还容易影响正在运行的连接。

dsh-mcp-manager（npm 包名 @js2hou/dsh-mcp-manager）由社区维护者 Js2Hou 发布，在 Web 界面的 设置 → MCP 提供 MCP 服务器的列表、增删、启用/停用与连接状态查看，修改经 HMR 写回补丁文件，无需手改 YAML。插件归类为客户端，MIT 许可；截至 2026-08-27，GitHub 约 11 stars。

这是什么¶

一句话：面向 DSH Web profile 的 MCP 可视化管理插件。

它在浏览器端注册 设置 → MCP 页签，通过仅限 loopback 的 Connection RPC（/mcp-manager）与宿主通信；浏览器不直接读写文件系统，所有持久化由宿主写入 profile 的 cordis.patch.yml。与纯手改配置相比，同一套数据多了实时状态、格式校验和连接探测。

核心功能¶

下面按 README 已列能力归纳，均可在安装后于 设置 → MCP 验证。

服务器列表：遍历 profile 中已安装的 @deepseek-ai/dsh-mcp-client 实例，展示 serverName、传输方式（stdio / streamable-http）、URL 或命令、启用状态、加载阶段、已注册工具数。

新增与删除：表单添加 MCP 服务器，支持 stdio 与 streamable-http；可配置 env、headers、args、超时、failOnStartupError 等字段，并对格式与重名做校验。删除为一键操作。

启用与停用：随时切换单台服务器；工具随启用状态热连接或热断开。

连接状态与测试：每台服务器显示状态胶囊（如 Connected · N tools、Failed、Loading、Disabled）。独立 Test 按钮执行 initialize + tools/list 探测，报告延迟与工具数。

编辑：在卡片原位展开表单，保存即应用。

多语言：界面文案跟随 DSH 语言设置（zh / en）。

持久化：变更写入 profile 的 cordis.patch.yml，重启后保留；页面底部显示当前补丁文件路径。

安装与启用¶

前置：本机已安装 DSH，且 dsh web 能正常运行（会初始化 ~/.dsh/profiles/web）。

推荐：dsh 命令安装

dsh plugin --profile web add @js2hou/dsh-mcp-manager

也可从 GitHub 源安装（仓库已包含构建产物 lib/，无需本地构建）：

dsh plugin --profile web add github:Js2Hou/dsh-mcp-manager

插件市场：插件已收录 dsh-market 与 dsh-plugin-marketplace，可搜索 js2hou/dsh-mcp-manager 安装；使用 DSH Desktop 时，可在内置市场中通过 DSH 1024Store 或 dshfind 源搜索同名插件，认准作者 Js2Hou。

一键脚本（macOS / Linux）：

curl -fsSL https://raw.githubusercontent.com/Js2Hou/dsh-mcp-manager/main/scripts/install.sh | bash

装完后对浏览器做硬刷新（Cmd/Ctrl+Shift+R），打开 设置 → MCP。若页签未出现，重启一次 DSH（host 侧首次挂载可能需要）。

更新：再次执行 dsh plugin --profile web add @js2hou/dsh-mcp-manager，或重跑安装脚本。

典型用法¶

打开 设置 → MCP 后，按 README 说明操作即可。

添加 stdio 服务器：填写条目 ID、serverName，传输方式选 stdio，再填 command、args、env、cwd 等。streamable-http 则填 URL 及所需 headers。

日常运维：在列表中查看每台服务器的实时状态与工具数；需要确认连通性时点 Test；临时不用某台可 停用，不必删配置；改参数用 编辑，保存后等待 HMR 应用（通常 1–2 秒，也可点页面右上角手动刷新）。

可选配置：loader 行支持 patchFile 字段，指定要编辑的用户补丁层绝对路径；默认 $DSH_HOME/profiles/web/cordis.patch.yml。

适用场景与注意¶

适合谁：在 DSH 里维护多台 MCP、需要一眼看清连接状态、或不想频繁手改 cordis.patch.yml 的开发者与智能体配置者。

权限与安全：插件以当前 DSH 进程权限运行，会读写 profile 补丁并触发 MCP 客户端连接。安装前建议查看 源码 与 MIT 许可证，确认配置内容（尤其 env、headers）不含不应暴露的密钥。

常见问题（摘自 README）：若出现两个 MCP 页签，检查 cordis.patch.yml 是否残留旧的手动挂载行；新版本报 minimum release age 时可等 24 小时，或按 README 在 pnpm-workspace.yaml 中为 @js2hou/dsh-mcp-manager 配置 minimumReleaseAgeExclude；Obsidian 等需 Bearer 认证的 MCP，headers 应为 Authorization: Bearer <api-key>，不要多余引号。

社区插件目录 SkillHub 与上述市场为独立生态站点，与 DeepSeek / 幻方无官方从属关系。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/Js2Hou/dsh-mcp-manager
• 源码与文档：https://github.com/Js2Hou/dsh-mcp-manager
• npm：@js2hou/dsh-mcp-manager（当前 README 对应版本 0.1.5）