dsh-plug-mcp

dsh-plug-mcp

DeepSeek Harness 的 MCP 服务管理器：在 Web UI 的「设置 → 插件 → MCP」标签页中发现 GitHub 上的 MCP 服务仓库，查看详情后一键安装 / 移除。交互模式参考 dsh-plug-manager （插件市场）；Agent Skills 管理请见姊妹插件 dsh-plug-skills。

功能

• 设置 → 插件 → MCP（Web UI）
  • 发现：按 GitHub topic 搜索 MCP 服务仓库——mcp-server / modelcontextprotocol，可追加关键词、按最多 Star / 最近更新排序、 翻页。
  • 详情弹窗：仓库星标 / topics / 许可证 / README（内置安全 Markdown 渲染，只放行 http(s) 链接，相对图片改写为 raw.githubusercontent.com）， 外加内容探测——package.json（npm 发布状态）/ pyproject.toml （PyPI 发布状态）/ README 中的 npx、uvx、docker run 线索，给出 候选启动命令，点选即填入安装表单；也可完全手工填写。
  • 安装：在用户 patch 层 $DSH_HOME/cordis.patch.yml（home 层， 作用于所有 profile）追加一行 @deepseek-ai/dsh-mcp-client 配置 （stdio：command / args / env；streamable-http：url / headers）。 DSH 对用户 patch 层做 HMR 监视——保存即热重载，通常无需重启。 写入前备份原文件（$DSH_HOME/.plug-mcp-backups/，保留 10 份），写入 后回读解析校验，绝不写出无法启动的 YAML；编辑为文本级追加 / 删除， 保留文件中的注释与 !!js 表达式。
  • 已安装：列出 home 层与各 profile 层中的全部 @deepseek-ai/dsh-mcp-client 行（服务名 / 传输方式 / 命令或 URL / env 键 / 所在层），自定义确认弹窗后一键移除。
  • GitHub 代理：直连 GitHub 受限时，可在页面上直接配置代理并测试 连通性（见下文「代理配置」）。
• 本地 JSON API（仅回环地址，由运行中的 web 服务器提供）： /plug-mcp/search、/plug-mcp/repo、/plug-mcp/local、 /plug-mcp/install、/plug-mcp/remove、/plug-mcp/proxy、 /plug-mcp/proxy-test。

代理配置

发现功能访问 api.github.com / raw.githubusercontent.com，候选探测还会 访问 registry.npmjs.org / pypi.org。出厂部署不挂载平台级 fetch provider，本插件自行发起请求：默认直连（Node fetch）；配置代理后经系统 curl 发出，因此支持 http / https / socks5 / socks5h / socks4 （Clash 的混合端口与 SOCKS 端口都可用）。

代理来源按优先级生效：

1. 持久设置（UI「GitHub 代理」栏输入后点「应用」）——写入 DSH 主目录/plug-mcp.json，立即生效且重启后保留；点「清除」移除；
2. 插件配置——在 profile 的 cordis.patch.yml 中为本插件加 config.proxy（持久生效）：

   - id: plug-mcp
     name: dsh-plug-mcp
     config:
       proxy: http://127.0.0.1:7890
   

3. 环境变量——DSH_PLUG_MCP_PROXY，或标准的 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY（大小写均可）。

「测试连接」会请求 api.github.com/zen 验证当前生效通道并报告延迟。 特殊值 direct 可强制直连（同样会被持久保存）。

注意：代理只影响本插件的 GitHub / 注册表探测请求；MCP 服务运行时 （npx / uvx / docker）的网络由它们自己的配置管理。

数据与安全

• MCP 服务以标准 @deepseek-ai/dsh-mcp-client 行登记在 $DSH_HOME/cordis.patch.yml（home 层，作用于所有 profile）。
• 每条 MCP 服务命令都是沙箱外的受信可执行代码（等同于你亲手在 shell 里跑 npx -y …）——只安装你信任源码的服务，http 类服务请确认 目标地址。想换用 !!js 表达式（如 !!js process.env.X）引用环境变量 时，直接编辑 patch 文件即可，本插件的解析 / 回写完整保留 !!js 标量。
• 所有安装 / 移除均由你本人在本地界面点击触发，宿主进程直接执行文件 操作，不经过 agent、不额外审批；操作结果即时反馈。
• patch 文件每次修改前自动备份；文本级编辑失败或回读校验不通过时放弃 写入，原文件不动。

安装

要求宿主有 curl（macOS / 主流 Linux 自带）才能使用代理功能； dsh plugin 命令要求 PATH 中有 pnpm。MCP 服务运行时按你选择的启动 方式自备 npx（Node）/ uvx（uv）/ docker。

# npm 安装（推荐）
dsh plugin --profile web add -w dsh-plug-mcp

# GitHub 源码（最新 main；也可 #vX.Y.Z 锁 tag）
dsh plugin --profile web add -w github:Casually/dsh-plug-mcp

# 本地目录（开发自用，在本目录的父目录下执行）
dsh plugin --profile web add -w ./dsh-plug-mcp

经 dsh plugin 命令安装后重启 DSH（dsh web）以组合新 bundle。 安装完成后，「MCP」标签页出现在设置 → 插件 下。

卸载

dsh plugin --profile web remove dsh-plug-mcp

重启 DSH 以移除该层。已登记的 MCP 服务不受影响（它们是配置，不是插件 的一部分）；如需清理，先在「已安装」页移除。

开发说明

• 运行时依赖仅 js-yaml（与 harness 同源的 YAML 方言：!!js 表达式 标量按 include 的 entryListSchema 原样往返）。
• 宿主插件是纯 ESM；GitHub 抓取默认直连，代理经系统 curl；30 秒超时、 5 MB 响应上限、10 万字符文本上限。
• 浏览器端以预构建形式交付（client.js，window.__ModuleLoader__ 格式），仅依赖平台的 react wire 模块。
• 给自己仓库打上 mcp-server topic 标签，即可出现在「发现」中。

许可证

MIT