MCP 服务器管理LongSir0419/dsh-mcp-manager

dsh-mcp-manager

npm
npm downloads
License: MIT

preview

功能特性

- 列表概览：进入 设置 → “MCP Manager”，每个服务器显示连接状态（绿点）+ 已注册工具数量
- 点击展开 / 折叠：点击行的任意位置可展开详情（Server name / module / 配置 JSON），再次点击可折叠（输入框和按钮除外）
- 添加 / 编辑 / 删除 / 启用-禁用：内联表单配置 MCP 服务器（serverName、module、配置 JSON），启用/禁用开关，写入 $DSH_HOME/profiles/web/cordis.patch.yml
- 连接测试：独立的 MCP 握手（initialize + tools/list）以验证可达性、工具数量和延迟
- 缓存优化：重新进入页面即时加载（stale-while-revalidate）；未连接的服务器会在后台自动验证；添加/编辑/删除在本地更新状态，无闪烁

架构

单包、两半的 DSH bundle：

| 部分 | 入口 | 作用 |
|---|---|---|
| Host | lib/index.js | mcpInventory Remote 服务：list/add/update/removeServer/test，读写 cordis.patch.yml，统计工具数量 |
| Client | lib/client.js | 设置面板中的 “MCP Servers” 区块（dsh.client bundle，由 client-modules 自动发现） |

该包通过 dsh.bundle.patch（cordis.patch.yml）声明自身，并在 dsh plugin 安装后自动挂载。

安装

前置条件

- 已安装 DeepSeek Harness (dsh)
- Web profile (dsh web) 可用

安装（已发布到 npm）

dsh plugin --profile web add @wanghailong0419/dsh-mcp-manager
dsh web   # 重启以生效

npm 包：https://www.npmjs.com/package/@wanghailong0419/dsh-mcp-manager

本地开发 / 未发布版本（file 源）

dsh plugin --profile web add file:/path/to/dsh-mcp-manager/bundle
dsh web

升级 / 移除

dsh plugin --profile web update @wanghailong0419/dsh-mcp-manager
dsh plugin --profile web remove @wanghailong0419/dsh-mcp-manager

dsh plugin add 会自动将包添加到 dsh.profile.bundles 层（它会检测 dsh.bundle 声明）——无需手动编辑配置。

使用方法

1. 启动 dsh web，打开 设置 → MCP Manager
2. 每个服务器行显示：名称、状态点（绿色/红色）、工具数量
3. 点击一行可展开：查看 Server name / module / 配置 JSON，测试连接、编辑、删除
4. 添加：点击“添加”，内联填写 serverName / module / config JSON
5. 启用/禁用：切换行右侧的开关

更改会写入 cordis.patch.yml，并在重启 dsh web 后生效（Web 模式下已禁用 HMR）。

配置示例

- id: mcp-example
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: example
transport: stdio
command: npx
args: ['-y', '@modelcontextprotocol/server-xxx']
env:
TOKEN: !!js process.env.MY_TOKEN

已知限制

- 宿主服务需要 tools 服务：toolCount 依赖于 DSH 的工具注册表
- 测试 idea/pycharm：stdioMcpServer 模式会再次启动 IDE 进程，因此耗时更长

图标说明

设置面板左侧导航中的“MCP Servers”图标会在插件激活时自动打补丁（向官方 dsh-client-ui-settings-general 的 navIcon 注入一个 MCP logo 分支；幂等且失败时静默）。如果 DSH 升级覆盖了官方包，补丁会在下次启动时自动重新应用——无需手动操作。

升级说明：如果你是从早期手动安装升级而来，请先从 cordis.patch.yml 中移除手动添加的 mcp-inventory / ui-settings-mcp 条目（该 bundle 会自动提供它们；重复会导致服务冲突）。全新安装可忽略此项。

许可证

MIT