前置条件要求 DSH ≥ 0.1.2-alpha.1、Node.js ≥ 18 以及 pnpm ≥ 9。该插件由 sojo-negai 维护,旨在通过 Web 界面简化 DSH 中 MCP 服务器的配置与监控流程。它支持直接在 DSH 设置页面编辑 JSON 配置,实时查看连接状态,并自动完成工具注册,无需手动修改文件或重启程序。
核心功能¶
- 图形化管理:在 DSH 设置 → 「MCP 服务器」页直接编辑 JSON 配置,无需手动修改 yml 文件。
- 实时状态:每台服务器显示一个状态圆点 —— 🟢 已连接 / 🟡 连接中(闪烁)/ ⚪ 未连接或已禁用。
- 独立启停:每台服务器支持
enabled开关,禁用操作不会删除配置,仅停止连接。 - 自动重连:保存配置后,插件会自动重连并重新注册工具,无需重启 DSH。
- 格式兼容:直接粘贴 Claude Desktop 风格的
mcpServersJSON 即可导入配置。
安装与启用¶
克隆仓库后,在项目根目录执行以下命令进行构建和安装:
pnpm install && pnpm build
node scripts/install.mjs --profile web
安装完成后,刷新依赖并重启 DSH 即可使用。
使用流程¶
- 启动 DSH,打开 Web 界面。
- 侧边栏点击「设置」,顶部 tabs 切换到「MCP 服务器」。
- 点击「修改配置(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.ymlpatch 文件将 TS 入口挂进 profile,该文件不入库。 - 权限:插件以当前 DSH 进程权限运行,请确保配置的命令路径和环境变量在当前环境中可用。