前言¶
在 DeepSeek Harness（DSH）中，MCP（Model Context Protocol）服务的接入通常涉及手动维护配置文件。dsh-plug-mcp 插件提供了一个 Web 界面，解决了在 Web UI 的「设置 → 插件 → MCP」标签页中发现 GitHub 上的 MCP 服务仓库、查看详情以及一键安装或移除的需求。
插件介绍¶
dsh-plug-mcp 是由 Casually 开发的 DeepSeek Harness 插件，定位为 MCP 服务管理器。它通过 Web UI 与 GitHub 注册表交互，允许用户按 Topic 搜索仓库，自动探测发布状态和启动线索，并将服务配置写入 DSH 的 home 层。
核心功能¶
-
仓库发现与搜索
支持按 GitHub topic（如mcp-server、modelcontextprotocol）搜索仓库。用户可追加关键词，并按最多 Star 或最近更新排序，支持翻页。 -
详情查看
点击仓库可查看详情弹窗，内容包括星标数、Topics、许可证、README 以及内容探测结果。探测会检查package.json（npm 状态）、pyproject.toml（PyPI 状态）以及 README 中的npx、uvx、docker run等启动线索，自动填充安装表单。 -
一键安装与移除
确认信息后点击安装，插件会在$DSH_HOME/cordis.patch.yml（home 层，作用于所有 profile）中追加@deepseek-ai/dsh-mcp-client配置行。
安装后，DSH 会监视该文件的 HMR（热重载）变化，通常无需重启即可生效。移除功能支持在已安装列表中一键删除配置。 -
代理配置
发现功能默认直连 GitHub。当网络受限时，可在 Web UI 的「GitHub 代理」栏配置代理。配置来源按优先级生效：UI 持久设置、profile 的cordis.patch.yml中的config.proxy、以及环境变量DSH_PLUG_MCP_PROXY。支持http、https、socks5等协议。 -
本地 API
插件提供本地 JSON API（仅监听回环地址），包括/plug-mcp/search、/plug-mcp/repo、/plug-mcp/local、/plug-mcp/install、/plug-mcp/remove、/plug-mcp/proxy和/plug-mcp/proxy-test。
安装与启用¶
使用 DSH 官方插件命令安装。安装后需重启 DSH 以组合新 bundle，此时「MCP」标签页将出现在设置 → 插件 下。
# 推荐使用 npm 安装
dsh plugin --profile web add -w dsh-plug-mcp
使用说明¶
- 在 Web UI 中进入「设置 → 插件 → MCP」。
- 在发现页输入关键词进行搜索。
- 如需访问受限的 GitHub，点击「GitHub 代理」栏配置代理并测试连接。
- 点击仓库查看详情，确认启动命令后点击「安装」。
- 在「已安装」页可查看当前注册的所有 MCP 服务，并执行移除操作。
注意事项¶
- 依赖要求：宿主环境需安装
curl（用于代理请求）和pnpm（用于dsh plugin命令）。 - 代码运行环境：MCP 服务以标准
@deepseek-ai/dsh-mcp-client行登记。每条 MCP 服务命令都是沙箱外的受信可执行代码，等同于在 shell 中运行npx -y …。请仅安装可信源码的服务。 - 配置文件：所有安装与移除操作直接修改
$DSH_HOME/cordis.patch.yml。插件会在修改前备份文件（保留最近 10 份），并校验写入后的 YAML 可读性，避免写入损坏的配置。 - 技术栈：插件仅依赖
js-yaml。
总结¶
dsh-plug-mcp 为 DeepSeek Harness 用户提供了可视化的 MCP 服务管理能力。通过 GitHub 探测和本地配置管理，它简化了服务接入流程，支持热重载和代理配置，适合需要在 DSH 中快速集成和调试 MCP 服务的场景。
