@wingsky-1/dsh-mcp-manager

DSH（DeepSeek Harness）的 MCP 服务器管理插件：会话界面右上角浮窗 + 分级面板 + 快速接入（手工表单 + 粘贴 mcpServers JSON 导入，不预设任何服务器），支持 项目级 MCP 跟随会话切换。已连接服务器的工具以 mcp__<serverName>__<rawName> 注册给模型直接调用。MCP 协议客户端基于 node:child_process 与全局 fetch 直接实现，无需额外安装。

安装

前提：已安装 DeepSeek Harness 且 dsh web 可正常启动（未全局安装 dsh 见下方「未全局安装 dsh」）。

安装插件（add）

dsh plugin --profile web add @wingsky-1/dsh-mcp-manager

卸载插件（remove）

dsh plugin --profile web remove @wingsky-1/dsh-mcp-manager

更新插件（update）

dsh plugin --profile web update @wingsky-1/dsh-mcp-manager

安装 / 卸载 / 更新后都需重启一次 dsh web（bundle 层只在启动时组合）生效。

指定版本号（@version）

省略 @版本号 即安装默认 latest（推荐）。仅当 registry 尚未同步到最新、或最新版在你的环境有问题时，在包名后追加 @版本号：

dsh plugin --profile web add @wingsky-1/dsh-mcp-manager@<版本号>

未全局安装 dsh

若本机没有全局 dsh 命令，用 npx 临时拉起（底层调用 pnpm，仍需本机装好 pnpm 与 Node.js）：

npx @deepseek-ai/dsh plugin --profile web add @wingsky-1/dsh-mcp-manager
npx @deepseek-ai/dsh plugin --profile web remove @wingsky-1/dsh-mcp-manager
npx @deepseek-ai/dsh plugin --profile web update @wingsky-1/dsh-mcp-manager

能力

| 能力 | 说明 | | --- | --- | | 右上角浮窗 | 状态点 + 计数摘要（MCP 2/3），点击展开下拉面板；随会话切换自动刷新 | | 项目级 MCP | 服务器分「项目级 / 全局」两级：项目级存 <项目根>/.dsh/mcp.json（随项目走、可提交 git），全局存 <DSH_HOME>/dsh-mcp.json 常连 | | 分级展示 | 运行中 / 连接中 / 重连中 / 未连接 / 已停用 / 失败；每台显示传输、端点、工具数 | | 服务器管理 | 增删改查（可选项目级/全局）、连接 / 断开 / 重连；配置版本化 JSON，原子写入 | | 两种传输 | stdio（本地子进程，env 支持 ${ENV} 引用）与 streamable-http（远程，header 支持 ${ENV} 引用，自动回传 Mcp-Session-Id） | | JSON 导入 | 粘贴 mcpServers JSON 文本导入（仅 JSON 格式；不扫描任何应用配置文件） | | 模型工具 | 已连接服务器的工具以 mcp__<server>__<tool> 注册（64 字符、[A-Za-z0-9_-]、冲突时哈希后缀） | | 断线重连 | 指数退避（500ms 起、30s 上限、10 次后放弃并注销工具） | | 结果截断 | 工具结果按 8KB 截断并标注（防超长 JSON 全量进上下文） | | 超时下探 | 工具调用超时默认 60s → 15s（可按服务器 toolCallTimeoutMs 覆盖） |

配置（浮窗位置）

浮窗按钮（MCP 胶囊）的位置与偏移在 dsh 设置 → 插件 → MCP 管理器 的插件卡中配置 （position / offset），走插件自身 Config 标准 cordis 配置注入，无需手改任何配置文件。

| 键 | 值域 | 默认 | | --- | --- | --- | | position | top-right（右上，默认）/ bottom-right（右下） | top-right | | offset.x | 非负整数（水平偏移，单位 px） | 8 | | offset.y | 非负整数（垂直偏移，单位 px） | 8 | | offset.blankY | 非负整数（空白会话垂直偏移，单位 px） | 40 |

当 position = bottom-right 时，下拉面板会在胶囊上方展开（底部锚点向上弹出）， 不溢出视口、内容完整可见可点击；top-right 时向下展开（历史行为，默认不变）。

在设置页保存后即时生效，无需重启 dsh web、也无需手动刷新页面：宿主端经既有 SSE events 通道推送一变，客户端自动重新拉取 /api/dsh-mcp/config 并就地更新浮窗位置。

路由（全部 loopback 围栏）

| 路由 | 说明 | | --- | --- | | /api/dsh-mcp/health | 健康检查（注意与目录名不同） | | /api/dsh-mcp/* | 服务器管理 / 连接控制 / 工具清单 / SSE 事件等 |

数据与安全

• 服务器配置：<DSH_HOME>/dsh-mcp.json（仅存 ${ENV} 引用，不落盘密钥本身）； 落盘 0600 权限 + 原子写入
• 所有 /api/dsh-mcp/* 路由仅限 loopback 访问（非回环 403 / 方法错 405）
• stdio 子进程环境净化：父环境去除凭据形状（KEY/TOKEN/SECRET/PASSWORD…） 与陈旧 DSH_* 变量后再合并显式 env——避免把宿主机密透传给 MCP 子进程
• stdio 子进程继承宿主权限：MCP 服务器命令在宿主进程权限下执行， 仅配置可信的服务器
• MCP 工具在真实服务器上执行，先确认再操作；工具结果原样返回， 可能含敏感信息；工具描述/结果按不可信输入对待
• 能力目录注入含来源标注与"不代表当前连接状态"说明

验证

# 健康检查（回环）
curl -s http://127.0.0.1:3080/api/dsh-mcp/health

# 源码在 src/，改后必须 build
pnpm --filter @wingsky-1/dsh-mcp-manager build
node test/smoke.mjs

已知限制

• 不订阅 MCP 的 tools/list_changed 通知（无 SSE 长连接）；工具列表变化在 重连 / 手动刷新时重新同步
• 仅桥接工具能力；MCP 的 resources 与 prompts 尚无 harness 消费接口
• 依赖 Node ≥ 20

类型依赖

宿主端类型来自官方 @deepseek-ai/* 包（cordis / dsh-host-webserver / dsh-agent / dsh-tools / dsh-system-prompt，版本统一锁在仓库 pnpm-workspace.yaml catalog， 随 DSH 发布节奏升级）：仅 import type 编译期使用，编译产物零官方运行时导入。 包以 optional peerDependencies 声明这一宿主耦合；对插件做类型检查的消费者需可解析 这些官方包（跳过类型检查则无影响）。

License

MIT