@dong-victor/dsh-mcphub

DSH Web GUI 插件：把本地 MCPHub（@samanhappy/mcphub，Dashboard 默认 http://localhost:3000）一站式聚合暴露的全部 MCP server 工具桥接进 DSH，让 agent 在会话里直接调用。

MCPHub 自身就是一个 MCP server：它把所有已启用的 server 聚合在一个 Streamable HTTP 端点 /mcp（全局路由，工具名投影为 <server名>-<工具名>；也可用 /mcp/<group> 分组路由）。本插件用官方 MCP SDK 作为客户端连接该端点，把发现到的每个工具注册为 DSH 原生 agent 工具：

mcp__mcphub__<server名>-<工具名>
# 例：mcp__mcphub__cassiopeia-ap-mysql-execute_sql

调用时参数 schema 与 MCPHub 发布的一致；tools/call 原样转发原始工具名（不做名字解析），调用结果按 MCP 文本块投影回模型上下文。

能力

• 工具桥接：连接 MCPHub 聚合端点（或分组端点），注册全部工具为 agent 原生工具（命名规范与 @deepseek-ai/dsh-mcp-client 一致：64 字符限制、非法字符替换、必要时追加确定性 hash）。
• agent 工具：
  • mcphub_status —— 连接状态、端点、server / 工具清单（含 DSH 可调用名）、MCPHub /health；
  • mcphub_resync —— 强制重新同步工具集（MCPHub 侧增删改 server / 工具后使用）。
• 侧边栏「MCPHub」入口：作为侧边栏底部 foot 区域（footArea）的直接子节点，插在设置区域（settingsArea，即「设置」按钮）上方；footArea 不存在的老宿主自动回退为「设置在 settingsArea 内、trigger 上方」（连接状态点 + 工具数概览；折叠侧边栏时自动切换为图标形态），点击打开状态面板。
• 状态面板：连接徽章、端点 / 分组 / 健康 / 上次同步 / 最近错误、按 server 分组的工具清单（可展开）、「打开 MCPHub Dashboard」外链、手动刷新。
• 健壮性：断线自动指数退避重连（工具在中断期保持注册、调用报错，恢复后自动重同步）；监听 notifications/tools/list_changed 热同步工具集；MCPHub 不可达时插件照常激活，状态面板如实显示。
• 宿主路由：GET /api/dsh-mcphub/status（环回地址保护、TTL 缓存、?refresh=1 绕过）。

安装

前置：本机已运行 MCPHub（mcphub，http://localhost:3000），且其中已启用至少一个 server。

# 从本地目录安装（与本仓库 dsh-jupyter 同样的 link 方式）
dsh plugin --profile web add link:C:\Users\dongz\.dsh\workspace\dsh-mcphub

或发布到 npm 后：dsh plugin --profile web add @dong-victor/dsh-mcphub。

安装后重启 dsh web 宿主进程（本插件是新 bundle，需要宿主重新加载 profile 才能生效）。

配置（可选）

在 profile 的 cordis.patch.yml 中按需覆盖：

- id: mcphub
  name: '@dong-victor/dsh-mcphub'
  config:
    baseUrl: http://localhost:3000   # MCPHub 地址
    group: ''                        # 留空=全局聚合 /mcp；填分组名= /mcp/<group>
    serverName: mcphub               # 工具命名空间（mcp__<serverName>__…）
    headers: {}                      # 附加 HTTP 头，如 { Authorization: 'Bearer xxx' }（MCPHub 开启 bearer 认证时）
    announceToAgent: true            # 是否向 agent 公告本插件
    toolCallTimeoutMs: 60000         # 单次 tools/call 超时
    reconnect:
      enabled: true
      initialDelayMs: 500
      maxDelayMs: 30000
      maxAttempts: 10

开发

npm install        # 安装依赖（@modelcontextprotocol/sdk、zod、jsdom 等）
npm test           # host-boot 冒烟 + 客户端 DOM 冒烟 + 对真实 MCPHub 的桥接端到端测试
npm pack           # 打包发布

测试说明：bridge-live.test.mjs 会真实连接本机 http://localhost:3000 的 MCPHub，发现工具并调用一个只读工具（如 get_schema_info），需要 MCPHub 在线。

已知限制

• 只桥接工具能力：MCP 的 resources / prompts 暂不暴露（与 dsh-mcp-client 相同）。
• 工具名中的 <server名> 前缀来自 MCPHub 配置；在 MCPHub 中改名会导致工具名变化（可 mcphub_resync 刷新）。
• 面板中的 server 分组基于工具名前缀启发式推断（展示用），调用始终使用完整工具名，不受影响。
• 依赖 MCPHub 服务在线；服务端会话在插件重连后会重建。

许可

MIT