前言¶
在 DSH 里接入 Model Context Protocol（MCP）服务器，常见做法是自己改 profile 下的 cordis.patch.yml，或从 Claude Desktop、Cursor、VS Code 等环境里复制 JSON/YAML 再手工合并。格式不统一时还要对照各产品的字段名，写错一处往往要到 Loader 日志里排查。下面介绍的 dsh-mcp-installer 由社区维护者 EquityQ 发布，在 DSH 设置 → MCP 安装 提供可视化导入、解析与安全提示，并把选定服务器写入当前 profile 的 cordis.patch.yml。
这是什么¶
dsh-mcp-installer 是 DeepSeek Harness 的 Web 端设置页插件（分类：admin-security）。它在导入前解析配置并做风险提示，确认后把 MCP 服务器登记到当前 profile，与 DSH Loader 中「已安装」列表联动。配置落盘位置为当前 profile 的 cordis.patch.yml，不是独立的全局配置文件。
核心功能¶
查看已安装服务器¶
打开 设置 → MCP 安装 后，页顶会显示当前 profile 的目标配置文件路径及是否可写。「已安装」页列出 DSH Loader 中生效的 MCP 服务器，包括来源层、传输方式、连接状态和工具数量；可按名称、命令或 URL 搜索，点击行可展开详情，刷新可重新读取实时状态。
添加服务器¶
- 选择 安装新服务器。
- 粘贴 MCP 配置，或选择
.json、.yaml、.yml、.toml、.md、.markdown、.txt文件；也可填写文档或配置页链接并选择 读取并解析。 - 选择 解析文本（链接导入会自动解析），检查各服务器的传输方式、命令或 URL 以及安全风险；按需确认风险提示，并勾选要安装的服务器。
- 选择 安装所选服务器。完成后在「已安装」查看运行状态；新会话或重启后生效，启用 HMR 时会自动重载。
解析器支持多种来源格式：mcpServers（Claude Desktop / Claude Code / Cursor）、servers（VS Code）、[mcp_servers.<name>]（Codex）、普通 YAML 与 Markdown 代码块，以及 Claude/Codex CLI 命令。传输方式支持 stdio 与 streamable-http，不支持 SSE。
编辑或删除仅适用于当前 profile patch 中可唯一定位的服务器；来自 home patch、bundle 等其他层的服务器需在对应配置层管理。
安全相关行为¶
- 导入的 env/header 值会写入 profile patch；敏感值建议使用 DSH 支持的
!!js环境变量表达式。页面只显示键名，编辑时保留原值。 - 高风险命令或 URL 需要用户确认；通过网页导入时会拒绝本机和内网地址。
安装与启用¶
官方建议安装 v1.1.1 及以上，该版本包含相关错误修复。安装前可先查看 npm 上的当前发布版本：
npm view dsh-mcp-installer version
普通 DSH CLI 用户可将插件安装到 web profile（将 web 换成你实际使用的非 Desktop profile）：
dsh plugin --profile web add dsh-mcp-installer
指定版本：
dsh plugin --profile web add dsh-mcp-installer@1.1.1
安装最新版本：
dsh plugin --profile web add dsh-mcp-installer@latest
安装后打开或重启该 profile，在 设置 → MCP 安装 中使用。
DSH Desktop 的 desktop profile 由 Desktop 自带的 DSH 命令管理。先启动 Desktop 初始化 profile，再在 Desktop 提供的命令环境中执行：
dsh plugin --profile desktop add dsh-mcp-installer
不要用单独安装的通用 dsh CLI 管理 Desktop 的保留 profile。
典型用法¶
在「安装新服务器」中粘贴 Claude Desktop 风格的 JSON，解析并安装后，配置会写入当前 profile 的 cordis.patch.yml。README 中的示例如下：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}
经过上面的步骤确认风险提示并 安装所选服务器 后，可在「已安装」页核对连接状态与工具数。
适用场景与注意¶
适合需要在 DSH 中快速从其他 IDE 或文档迁移 MCP 配置、又希望在写入前看到安全提示的开发者与运维同学。插件以当前 DSH 进程权限运行，安装第三方 MCP 前仍应自行核对服务器命令、源码与许可证（本插件为 MIT）。社区目录页与 GitHub 仓库由维护者发布，与 DeepSeek / 幻方无官方从属关系。
插件包当前版本为 1.1.1（见仓库 package.json），GitHub 星标数为 1。
