前言¶
DeepSeek Harness (DSH) 采用了插件化架构，但在实际开发中，管理 MCP 服务器往往面临配置分散、连接状态不透明、工具调用难以追踪等痛点。现有的方式可能需要重启进程或依赖外部工具。dsh-mcp-studio 将这些功能集成到 DSH 的设置页面中，提供了一个无需重启即可生效的 MCP 服务器工作台。
是什么¶
dsh-mcp-studio 是 DeepSeek Harness (DSH) 的 MCP 服务器工作台，由 SeaOf0 维护。它解决的核心问题是：如何在 DSH 环境中实时挂载、监控和管理 MCP 服务器，以及如何便捷地导入和导出配置。
核心功能¶
-
实时挂载与热切换
每个启用的服务器由内置的@deepseek-ai/dsh-mcp-client桥接挂载。模型可以直接调用mcp__<名称>__<工具>。编辑配置即可热切换，禁用或删除会自动卸载。 -
真实连接状态
状态直接聚合自 DSH 工具注册表（ctx.tools.view()）。显示状态包括：已连接、启动中、未连接、失败（含错误详情）、已禁用。连接中会有脉冲呼吸灯效果。 -
工具预览浮层
点击“N 个工具”徽章弹出独立浮层，展示服务器名、工具总数及简介。支持即时筛选。浮层会自动适配视口（上下翻转、高度钳制、滚动跟随）。 -
工具调用监控
订阅会话事件流，记录每次调用的服务器、工具、耗时和成败。使用内存环形缓冲，容量 200 条，按 20 条/页翻页，支持按服务器筛选、两步确认一键清空，重启即清零。 -
连接诊断
一键发起独立的 MCP 握手（支持 stdio 临时子进程和 streamable-http 直连）。展示握手耗时、协商协议版本、服务器信息和工具数量。 -
JSON 一键导入
兼容 Claude Desktop、VS Code、Cline/Roo（含 disabled）等多种格式的配置文件。支持裸映射、无包装单对象、多层包装。自动识别 stdio/http、env/headers，重名会自动加后缀。 -
模板库
内置 9 个常用服务器预设：Everything、Filesystem、Fetch、Memory、Seq Thinking、Puppeteer、GitHub、Chrome DevTools、HTTP 示例。 -
配置导出
支持将当前全部配置或单台服务器一键复制为mcpServersJSON 格式。 -
排序与筛选
支持卡片拖拽排序（保存持久化）、按名称/命令/URL 搜索、四态状态筛选，以及紧凑/舒适密度切换。 -
设计
使用--dsw-alias-*主题令牌，明暗皮肤自适应。通过字号、间距和状态色表达层级，全程零 emoji 和零图标装饰。
安装与启用¶
前置条件：
* DeepSeek Harness (DSH) 版本 >= 0.1.0-rc.6
* Node.js 版本 >= 22.19 或 >= 24
安装命令：
npx @deepseek-ai/dsh plugin --profile web add github:SeaOf0/dsh-mcp-studio
安装后，重启 dsh web，在设置对话框中会出现 MCP 工作台（位于侧边卡片之下）。配置持久化保存在 ~/.dsh/settings.yaml 的 mcp-studio 段。
典型用法¶
- 添加或导入配置：点击“添加服务器”手动配置，或点击“粘贴 JSON”导入（抽屉内带有模板和格式化按钮）。也可以点击预设芯片一键填入。
- 对话调用：在对话中直接指令模型使用特定服务器，例如“用 github 服务器查一下 xxx 仓库”，模型会自动调用
mcp__github__*工具。 - 查看状态：统计条实时显示服务器、已启用、已连接及工具总数。卡片状态灯为绿色呼吸灯表示已连接。
- 诊断与调试：点击“N 个工具”徽章查看详情，或点击“测试连接”运行独立握手以查看协议版本和耗时。
适用场景与注意¶
适用于需要深度管理 MCP 服务器连接、工具调用情况及配置的 DSH 用户和开发者。
注意事项：
* 插件以当前 DSH 进程权限运行。
* 需确保宿主包已 external 化，运行时依赖从 ~/.dsh/profiles/node_modules 解析。
* 安装前建议检查源码与许可证。
结尾¶
dsh-mcp-studio 通过在设置页内集成挂载、监控、诊断和导入导出功能，解决了 MCP 服务器管理碎片化的问题。它通过热切换和持久化配置，降低了管理复杂度。
