前言¶
在 DSH 里接第三方 MCP，常见做法是改 profile YAML、记命令行参数和环境变量，或在多处配置里找「这条 MCP 到底挂在哪」。条目多了之后，启停、改 URL、换凭据、排查连不上，都要对着文本配置操作，还容易把密钥写进可回显的字段。
dsh-mcp-manager 是社区维护的 DSH 客户端插件（维护者 lyufeng000，分类：客户端），把 MCP 客户端条目的查看与日常运维收拢到 设置 → MCP 服务器。下面介绍它做什么、怎么用，以及安装与边界上需要注意的点。
这是什么¶
插件包名 dsh-mcp-manager，当前资料中的版本为 0.1.0（MIT 许可证）。它面向已在 DSH 桌面端使用 MCP 的开发者：在图形界面里管理 Loader 中的 MCP 客户端条目，而不是替代 DSH 自带的 MCP 协议实现。
生态上，DSH 强调「一切皆插件」；插件目录站点（如 SkillHub）由社区维护，与 DeepSeek / 幻方无官方从属关系。本文事实以 GitHub 仓库 README 为准。
核心功能¶
查看与列表¶
- 查看 MCP 管理器自身配置，以及当前 Loader 里已有的 MCP 客户端条目。
- 未挂载的 agent preset 中的服务器不会出现在当前 Loader 列表里（与平台加载范围一致）。
条目的增删改与连接¶
- 添加、编辑、启用、停用、重连、移除 第三方 MCP。
- 连接方式支持：
- stdio：命令、JSON 参数数组、工作目录、环境变量。
- Streamable HTTP：URL、请求头。
- 配置项支持三种模式：普通值、密钥、已有凭据引用。密钥经 DSH
credentials服务保存；仅在连接时取出，配置文件只存引用，界面不回显。 - 已有条目的参数不回显，用于降低历史配置里明文密钥泄漏的风险。
- 「已连接」表示初次连接及工具发现成功，不是持续的健康检查；失败时可点 重连。
谁能改、谁能删¶
- 只允许移除当前 profile 的
insert里显式添加的 MCP 条目。内置、组合包、继承或更高优先级配置为只读，需到所属配置或预设里管理。 - profile 移除走平台文件锁、YAML AST、DSH 配置组合器与重载机制；写回前备份，重载失败会回滚，并尽量保留
!!js与其他条目。
当前不支持的能力¶
资料中明确写明：旧式 SSE、OAuth 自动登录、任意 MCP JSON 导入暂不支持。
安装与启用¶
已抓取资料未提供形如 dsh plugin add … 的一行商店安装命令；README 给出的是在本机以源码目录接入的开发/本机安装流程（须确认后再执行）。禁止在未核对仓库的前提下凭包名拼接安装命令。
本机安装要点如下（顺序与 README 一致）：
- 备份 desktop profile 的
package.json、锁文件与cordis.patch.yml。 - 以
link:本地依赖接入插件目录（克隆后仓库根目录即为插件目录），不要按 npm 包名安装。 - 把
dsh-mcp-manager加入dsh.profile.bundles。本包自带 bundle patch，不要在 profile 里再插入重复挂载。 - 同步治理目录
Plugins.json，校验 profile 和账本。 - 完全退出并重新打开 DSH，再进入设置。README 注明：首次安装仅刷新页面不会加载 Host。
package.json 中声明的 DSH 引擎范围为：
dsh >=0.2.1-rc.2 <0.3.0
客户端侧依赖注入包括 @deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-client-modules、@deepseek-ai/dsh-client-ui-settings，入口在 Web 平台的设置 UI。
典型用法¶
打开入口¶
启动 DSH 后进入 设置 → MCP 服务器，即可对照 Loader 中的条目进行管理。
添加或编辑 MCP¶
- 按传输方式选择 stdio 或 Streamable HTTP，填写对应字段（命令/参数/工作目录/环境变量，或 URL/请求头）。
- 敏感信息优先用 密钥 或 凭据引用，不要写在命令、参数、URL 或普通值里。
- 编辑 密钥 时留空表示保留旧值；配置
Authorization等请求头时填入完整值，例如Bearer <token>。 - 凭据引用 填现有环境变量或 DSH 凭据名称，例如
MY_API_KEY。 - 启用 stdio 会执行你填写的命令；启用 HTTP 会把配置的请求头发给指定服务器。界面执行前会确认——请只连接可信 MCP。
插件不会自动安装 MCP 服务端软件；若配置使用 npx / uvx 等，可能按工具自身规则联网下载。
停用、重连与移除¶
- 临时不用可先 停用；连接异常时用 重连。
- 移除仅作用于当前 profile
insert中你添加的条目；删除配置不会卸载命令包，也不会删除凭据（备份或其他配置仍可能引用凭据）。
管理数据默认写在 profile 下的 mcp-manager/servers.json，上一版备份为 servers.json.bak。密钥的存储与加密能力遵从 DSH 凭据服务，插件不额外承诺磁盘加密。
适用场景与注意¶
适合谁：经常在 DSH 里切换、调试多个第三方 MCP，希望用设置页完成启停和凭据管理，并区分「我能改的 insert 条目」与「只读的内置/继承配置」的桌面用户。
安全与权限：插件以当前 DSH 进程权限运行；启用 stdio 即运行你配置的命令。安装前应阅读源码与 MIT 许可证，只接入可信 MCP。远程生产服务请使用 HTTPS。
开发与验证：仓库提供单元测试 node --test test/*.test.mjs；完整平台集成测试需设置 DSH_MCP_TEST_RUNTIME 等环境变量（见 README）。界面结构测试不等同于完整浏览器点击验收；桌面 GUI 验收需完全退出并重启 DSH。
结尾¶
dsh-mcp-manager 把 MCP 客户端条目的查看、编辑、启停、重连与受控移除集中到 设置 → MCP 服务器，并在凭据与只读边界上与 DSH 平台机制对齐。需要进一步了解或反馈问题，可看目录页与源码仓库：
- 目录页：https://www.skillhub.cn/plugins/lyufeng000/dsh-mcp-manager
- GitHub：https://github.com/lyufeng000/dsh-mcp-manager
