MCP 服务器工作台SeaOf0/dsh-mcp-studio

dsh-mcp-studio

DeepSeek Harness (dsh) 的 MCP 服务器工作台 —— 实时挂载、真实连接状态、工具预览、一键导入，全部在一个设置页里完成，保存即生效，无需重启。

一个面向 DeepSeek Harness (dsh) 的单页 MCP 服务器工作台：实时挂载服务器、直接从工具注册表获取真实连接状态、逐服务器工具预览、JSON 一键导入 —— 每次保存立即生效，永远无需重启。

功能亮点 / Features

| 能力 | 说明 |
|---|---|
| 实时挂载 | 每个启用的服务器由内置 @deepseek-ai/dsh-mcp-client 桥接挂载，模型以 mcp____ 直接调用；编辑即热切换，禁用/删除即卸载 |
| 真实状态 | 状态直接聚合 dsh 工具注册表（ctx.tools.view()），已连接/启动中/未连接/失败（含错误详情）/已禁用，连接中带脉冲呼吸灯 |
| 工具预览浮层 | 点“N 个工具”徽章弹出独立浮层：服务器名、工具总数、全部工具名与简介，支持即时筛选；浮层自动适配视口（上下翻转/钳制/压缩高度，滚动跟随） |
| 工具调用监控 | 订阅会话事件流，记录每次调用的服务器/工具/耗时/成败；内存环形缓冲 200 条（容量明示 N/200）、20 条/页翻页、按服务器筛选、两步确认一键清空、重启即清零 |
| 连接诊断 | 一键发起独立完整 MCP 握手（stdio 临时子进程 / streamable-http 直连），展示握手耗时、协商协议版本、服务器信息、工具数 |
| JSON 一键导入 | 兼容 Claude Desktop（{"mcpServers":…}）、VS Code（{"servers":…}）、Cline/Roo（含 disabled）、裸映射、无包装单对象、多层包装；自动识别 stdio/http、env/headers、重名加后缀 |
| 模板库 | 内置 9 个常用服务器预设芯片：Everything / Filesystem / Fetch / Memory / Seq Thinking / Puppeteer / GitHub / Chrome DevTools / HTTP 示例 |
| 配置导出 | 当前全部配置或单台服务器一键复制为 mcpServers JSON，与导入构成闭环 |
| 排序与筛选 | 卡片拖拽排序（保存持久化）、按名称/命令/URL 搜索、四态状态筛选、紧凑/舒适密度切换 |
| 设计 | 全程 --dsw-alias- 主题令牌（明暗皮肤自适应），层级靠字号/间距/状态色表达，零 emoji 零图标装饰 |

快速开始 / Quick Start

要求：dsh ≥ 0.1.0-rc.6（dsh plugin 自动登记 bundles 行为）、Node ^22.19 或 ≥24。

方式一：GitHub（本仓库）
npx @deepseek-ai/dsh plugin --profile web add github:SeaOf0/dsh-mcp-studio

方式二：npm（发布后）
npx @deepseek-ai/dsh plugin --profile web add dsh-mcp-studio

方式三：本地路径 / 内网
npx @deepseek-ai/dsh plugin --profile web add link:/path/to/dsh-mcp-studio

装完重启 dsh web，设置对话框出现 MCP 工作台（位于侧边卡片之下）。卸载同样一条命令：

npx @deepseek-ai/dsh plugin --profile web remove dsh-mcp-studio

使用 / Usage

- 添加服务器：点“添加服务器”手动配置，或“粘贴 JSON”导入现成配置（抽屉自带模板与格式化按钮，也可点预设芯片一键填入）
- 对话调用：直接对模型说“用 github 服务器查一下 xxx 仓库”，模型自动调用 mcp__github__ 工具
- 看状态：统计条实时显示服务器/已启用/已连接/工具总数；卡片状态灯绿色呼吸 = 已连接
- 查工具：点“N 个工具”徽章弹浮层；“测试连接”跑一次独立握手看协议版本与耗时

配置持久化在 ~/.dsh/settings.yaml 的 mcp-studio 段。

架构 / Architecture

src/
├── index.ts          # 宿主插件：settings namespace、挂载引擎（签名 diff 热切换）、
│                     # session/event 工具调用监控（环形缓冲 + inflight TTL 清扫）
├── types.ts          # schema、跨字段校验、mcp-client 配置投影、参数行切分
├── settings-rpc.ts   # loopback 通道：status / settings / diagnose / executions-clear
├── diagnose.ts       # 独立 MCP 握手（stdio 子进程 / HTTP 含 SSE 解析）
└── client/
├── McpStudioPage.tsx  # 统计条、筛选栏、拖拽排序、JSON 抽屉、执行记录表
├── ServerCard.tsx     # 状态灯卡片、工具预览浮层（视口自适应）、诊断面板
├── mcp-json.ts        # 全格式解析器 + 导出器（往返保真）
├── presets.ts         # 9 个内置模板
└── styles.ts          # 设计系统（--dsw-alias-* 令牌）

开发 / Development

pnpm install --config.minimum-release-age=0 --config.auto-install-peers=false
pnpm check   # typecheck + 15 个单测 + 构建（Host ESM bundle + Web client CJS bundle）
宿主 bundle 已将全部 @deepseek-ai/* 依赖 external 化，运行时从 ~/.dsh/profiles/node_modules（由 dsh CLI 维护的宿主包仓库）解析，用户机器无需额外安装；lib/ 随仓库提交，git 安装零构建、不触发 pnpm 构建白名单。

License

MIT