dsh-mcphub:给 DeepSeek Harness 加一个 MCP 管理面板

前言

如果你在 DeepSeek Harness(下文简称 DSH)里配过几个 MCP 服务器,大概熟悉这套流程:手动编辑 profile 的 cordis.patch.yml,重启 DSH,然后祈祷它连上了。至于服务器到底注册了哪些工具、pip 装的 stdio 服务器是不是有新版本,都没有一个地方能看到,只能翻日志或者去试。

jinhongxun/dsh-mcphub 解决的就是这个问题:它在 DSH 的设置面板里新增一个 MCP 分区,把连接状态、版本升级、添加服务器、连通测试这几件事搬到了界面上。下面介绍它的功能、安装方法和使用注意。

这是什么

dsh-mcphub 是一个 DSH 插件,由 jinhongxun 维护,许可证为 MIT,写作时版本为 0.3.1。它通过 DSH 的客户端注入机制(package.json 中 dsh.client.platformweb)在设置面板中挂载 MCP 分区,所有对 MCP 配置的查看和改动都在浏览器面板里完成。

核心功能

连接状态

分区里列出当前 profile 的所有 MCP 服务器,每个服务器一个状态点:

  • 绿点:该服务器的工具已注册进当前会话,AI 可以调用;
  • 灰点:已配置但未注册工具。

同时显示传输类型(stdio / HTTP)、目标地址、工具数量与样例。

状态点不是插件自己维护的:插件读取运行中的工具注册表,某服务器存在 mcp__<服务器名>__* 形式的工具注册即视为已连接。这样做零侵入,状态永远和真实能力一致;边界情况是「已连接但暴露 0 个工具」的服务器会显示为灰点。

升级管理

按服务器类型分三种处理:

  1. pip 安装的 stdio 服务器(如 scrapling):自动比对 PyPI 最新版,有新版时显示「可升级」徽标,一键执行 pip install --upgrade。Windows 下的文件锁问题已处理:先停掉占用进程,暂存旧 exe,失败时恢复。
  2. npx 型服务器:比对 npx 缓存中的实际版本,提供「刷新缓存」操作。
  3. @latest 型规格:每次启动自动拉最新,插件不做重复提示。

添加服务器

表单录入 serverName / transport,以及 URL+headers(HTTP 型)或 command+args+env(stdio 型),追加写入对应 profile 的 cordis.patch.yml,重启 DSH 后生效。不想用表单的也可以手动编辑配置,面板的使用说明里附有示例。

连通测试

  • HTTP 服务器:发送真实的 MCP initialize 握手,显示对方 serverInfo 与耗时;
  • stdio 服务器:校验可执行文件是否存在。

使用说明与隐私

面板内置使用文档,覆盖工具命名规则、如何让 AI 调用工具、手动编辑配置示例、密钥安全提醒和排障指引。

隐私方面值得单独说一句:配置文件里的 headers / env 密钥只在 Host 进程内存中用于探测握手,永远不会发送到浏览器端,面板只收到键名。

安装与启用

环境要求:Node.js ≥ 20,以及带 dsh-client-connection 通道的 DeepSeek Harness(官方发行版自带)。

安装命令:

# 从 GitHub
dsh plugin --profile web add github:jinhongxun/dsh-mcphub

# 或从 npm(如已发布)
dsh plugin --profile web add dsh-mcphub

npm 安装方式在 README 中标注为「如已发布」,是否已实际上架 npm 无法从现有资料确认,建议优先用 GitHub 方式安装。安装后需重启 DSH 生效。

典型用法

让 AI 调用 MCP 工具。DSH 中 MCP 工具的命名格式是:

mcp__<服务器名>__<工具名>

绿点的服务器,其工具已注册进会话,直接在对话里让 AI 调用即可。

理解 profile。profile 是 DSH 的「独立配置环境」,类似浏览器的多用户配置:每个 profile 有自己的插件和 MCP 列表,互不影响。比如一台机器上可以有 web(日常网页版)和 open-design 两套,各配各的 MCP。添加服务器表单里的 profile 选择决定写入哪套环境的 cordis.patch.yml——只有一个 profile 时无需关心这一项。

改动生效时机。所有配置改动(新增、暂停、删除、升级)都需要重启 DSH 后生效,面板上的操作只是改配置,不会热加载。

适用场景与注意

适合的场景:

  • 配了多个 MCP 服务器,想知道哪个真正连上了、注册了哪些工具;
  • 常用 pip / npx 安装的 stdio 服务器,需要跟踪版本升级;
  • 不想手改 YAML,希望用表单添加服务器并顺带验证连通性。

几点注意:

  • 兼容 Windows / macOS / Linux。升级动作按平台分流:PowerShell ↔ pkill、wherecommand -v、npm 缓存路径自动探测。
  • README 的截图部分标注「待补充」,目前以文字描述为主。
  • 安全提醒:插件以当前 dsh 进程的权限运行,安装第三方插件前建议先查看其源码与许可证。本插件源码在 GitHub 公开,许可证为 MIT(README 与 package.json 一致)。

结尾

dsh-mcphub 做的事不复杂:把 DSH 里 MCP 配置的「看状态、升版本、加服务器、测连通」收进设置面板,并且不自己维护状态,直接读运行中的工具注册表。如果你在 DSH 里用的 MCP 服务器不止一两个,装上它能省不少翻配置文件的时间。

  • GitHub:https://github.com/jinhongxun/dsh-mcphub
  • 插件目录页:https://www.skillhub.cn/plugins/jinhongxun/dsh-mcphub (社区维护的独立目录,与 DeepSeek / 幻方无官方从属关系)
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜