前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在使用 MCP (Model Context Protocol) 服务器时，传统的配置方式（如手动编辑 JSON 文件）不仅繁琐，而且调试困难。本文介绍的 dsh-mcp-servers-panel 插件旨在解决这个问题，它将 MCP 服务器的管理无缝集成到 DSH 的设置面板中，提供可视化的新增、查看、修改、删除及启停功能。
插件定位¶
这是一个为 DSH 提供原生 MCP 服务器管理界面的插件，由 whiteS18 维护，基于 MIT License 开源，归类于工作流类插件。
核心功能¶
1. 设置面板无缝集成¶
插件安装后，会自动在 DSH 设置的左侧菜单中添加「MCP Servers」选项卡。界面遵循 DSH 官方原生 UI 规范，使用纯 SVG 矢量图标。
2. 已安装 MCP 服务列表¶
在面板中可以清晰查看当前已配置的 MCP 服务器。列表展示名称、作用域（用户 / 项目）以及运行状态指示灯（在线绿色、禁用灰色、错误红色）。右上角提供「刷新」、「Add MCP +」、「Open MCP Config」快捷操作。每个服务器卡片支持点击展开，查看已发现的工具数量及描述，并提供独立的启停开关与删除确认。
3. 新建与编辑 MCP 服务¶
支持「表单」与「JSON」双模式切换编辑：
* 表单模式：直观输入服务名称、传输协议、可执行命令、参数、环境变量及端点 URL。
* JSON 模式：支持直接编辑完整配置，智能兼容单个配置对象、mcpServers 包装对象以及 Cursor / Claude Code 常见格式。
支持自由切换「作用域」：选择「用户（User）」将配置保存于 ~/.dsh/mcp-servers.json，选择「项目（Workspace）」则保存于 <workspace>/.dsh/mcp.json。
4. DSH 原生对话调用¶
插件会自动维护 MCP 进程的生命周期（stdio 管道或 HTTP 通信），并完成 MCP 协议握手（initialize -> notifications/initialized -> tools/list）。发现的工具会自动注册至 ctx.tools，供模型与会话直接调用。名称过长或包含非法字符时，会按 DSH 规则截断并附加哈希。
5. 跨平台与 Windows 兼容¶
- Windows stdio 增强：针对 Windows 上
spawn无法直接运行无扩展名脚本或.cmd/.bat的问题，插件会自动通过PATHEXT探测可执行目标并封装cmd.exe /d /s /c执行，解决ENOENT错误。 - 环境 PATH 智能探测：自动嗅探并补充常见全局环境路径（如 Node.js、npm、pnpm、scoop、mise、cargo 等），避免因 PATH 问题导致服务启动失败。
6. 诊断排查与可视化¶
展开服务器卡片可查看底层启动配置（传输类型、命令、工作目录等）。连接异常时会展示错误详情，配合 8 秒握手超时保护，避免子进程死锁。
安装与启用¶
- 环境检查：确保安装了 Node.js >= 20.0.0，并满足依赖项
@deepseek-ai/cordis (^4.0.0)和@deepseek-ai/dsh-tools (>=0.1.0)。 - 执行安装：
dsh plugin --profile <name> add dsh-mcp-servers-panel
- 重启应用：DSH 在进程启动时组合插件。安装后必须完全退出并重新打开 DSH（不是刷新页面）才能生效。
典型用法¶
- 启动 DSH Desktop 后，进入「设置」。
- 在侧边栏找到「MCP Servers」面板。
- 点击右上角「Add MCP +」新建服务。
- 在编辑弹窗中，根据需要选择「表单」或「JSON」模式输入配置，并设置「作用域」。
- 保存后，在列表中点击服务器卡片展开，确认工具已加载，并通过 DSH 原生对话调用这些工具。
注意事项¶
该插件以当前 DSH 进程的权限运行，建议在安装前检查源码与许可证。由于插件加载机制，任何配置更改或新增都需要完全重启 DSH 应用才能被识别。
结语¶
dsh-mcp-servers-panel 通过图形化管理解决了 MCP 服务的配置与调用问题，适合需要频繁调试或管理多个 MCP 工具的开发者。更多细节与源码可参考其 GitHub 仓库。
