dsh-mcp-plus:DSH MCP 服务器图形化管理插件

前置条件要求 DSH ≥ 0.1.2-alpha.1、Node.js ≥ 18 以及 pnpm ≥ 9。该插件由 sojo-negai 维护,旨在通过 Web 界面简化 DSH 中 MCP 服务器的配置与监控流程。它支持直接在 DSH 设置页面编辑 JSON 配置,实时查看连接状态,并自动完成工具注册,无需手动修改文件或重启程序。

核心功能

  1. 图形化管理:在 DSH 设置 → 「MCP 服务器」页直接编辑 JSON 配置,无需手动修改 yml 文件。
  2. 实时状态:每台服务器显示一个状态圆点 —— 🟢 已连接 / 🟡 连接中(闪烁)/ ⚪ 未连接或已禁用。
  3. 独立启停:每台服务器支持 enabled 开关,禁用操作不会删除配置,仅停止连接。
  4. 自动重连:保存配置后,插件会自动重连并重新注册工具,无需重启 DSH。
  5. 格式兼容:直接粘贴 Claude Desktop 风格的 mcpServers JSON 即可导入配置。

安装与启用

克隆仓库后,在项目根目录执行以下命令进行构建和安装:

pnpm install && pnpm build
node scripts/install.mjs --profile web

安装完成后,刷新依赖并重启 DSH 即可使用。

使用流程

  1. 启动 DSH,打开 Web 界面。
  2. 侧边栏点击「设置」,顶部 tabs 切换到「MCP 服务器」。
  3. 点击「修改配置(JSON)」,粘贴或编辑服务器配置,点击「保存」。

配置与状态说明

支持的配置格式

插件支持三种配置形态,推荐使用第一种(对象映射),因为它与 Claude Desktop 的 mcpServers 配置兼容:

{
  "chrome-devtools": {
    "command": "cmd.exe",
    "args": ["/c", "npx", "-y", "chrome-devtools-mcp@latest"],
    "enabled": true
  }
}

状态指示

列表中每台服务器名字前的圆点表示实时连接状态:
* 🟢 已连接:工具已注册,Agent 可调用。
* 🟡 连接中:正在启动或握手(闪烁状态),首次冷启动可能需要较长时间。
* ⚪ 未连接:连接失败,需检查 command/args 是否正确,或查看终端日志。
* ⚪ 已禁用:enabled: false,配置保留但未连接。

工具注册名

配置中定义的服务器名会作为前缀,工具注册名格式为:mcp__<服务器名>__<工具名>。

注意事项

  • 源码模式:若使用源码模式开发,需手动创建 cordis.yml patch 文件将 TS 入口挂进 profile,该文件不入库。
  • 权限:插件以当前 DSH 进程权限运行,请确保配置的命令路径和环境变量在当前环境中可用。

相关链接

羽毛球分组比赛记分
小程序二维码

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

小夜