@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 覆盖） |
路由（全部 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
