dsh-mcp-studio
> DeepSeek Harness (dsh) 的 MCP 服务器工作台 —— 实时挂载、真实连接状态、工具预览、一键导入，全部在一个设置页里完成，保存即生效，无需重启。
A one-page MCP server studio for DeepSeek Harness (dsh): live-mount servers, real connection state straight from the tool registry, per-server tool preview, JSON one-click import — every save applies immediately, no restart ever needed.
---
功能亮点 / 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 已 external 化全部 @deepseek-ai/* 依赖，运行时从 ~/.dsh/profiles/node_modules（dsh CLI 维护的宿主包仓库）解析，用户机器无需额外安装；lib/ 随仓库提交，git 安装零构建、不触发 pnpm 构建白名单。
License
MIT