前言¶
DeepSeek Harness (DSH) 采用插件化架构，管理 Model Context Protocol (MCP) 服务器通常需要直接编辑配置文件。dsh-mcp-ui 提供了一个可视化的 Web 设置卡片，允许用户在 DSH 界面中管理 MCP 服务器配置，替代手动编辑 settings.yaml。
插件定位¶
dsh-mcp-ui 是 DeepSeek Harness 的客户端插件，由 quan-v 维护。它负责提供设置卡片 UI、存储配置信息，并监听配置变化以自动管理 dsh-mcp-client 实例的挂载与卸载，无需用户重启 DSH 进程。
核心能力¶
- Settings card UI：在 DSH Web 设置中提供 MCP 服务器配置卡片，与其它 DSH 插件样式保持一致。
- 双传输支持：同时支持 stdio（本地进程）和 streamable-http（远程 URL）两种传输方式。
- 全字段覆盖：支持完整的配置项，包括
serverName、command/args/env/cwd、url/headers、tool-call timeout、startup-failure policy以及auto-reconnect（开启/延迟/上限/尝试次数）。 - Hot sync：保存配置时，主机侧会自动挂载或卸载对应的
dsh-mcp-client实例，无需重启 DSH。 - Safe：服务器列表存储在
~/.dsh/settings.yaml中，敏感信息通过环境变量引用。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add github:quan-v/dsh-mcp-ui
安装完成后重启 dsh web，在 Settings > Plugins > Plugin Config > MCP Servers 下即可找到该设置卡片。
使用方法¶
- 打开设置卡片，点击 + Add Server。
- 填写唯一的
serverName（模型调用的工具命名格式为mcp__<serverName>__<tool>）。 - 选择传输方式（stdio 或 streamable-http）并填写对应的字段。
- 点击 Save，主机自动建立连接，服务器提供的工具即可被模型调用。
注意事项¶
- 该插件不实现 MCP 协议本身，仅提供设置卡片和配置存储功能。
- 它通过监听配置变化，利用
ctx.plugin()在主机侧挂载或卸载官方dsh-mcp-client实例，实际的连接建立、工具发现和命名由官方客户端处理。 - DSH 0.1.1+ 版本要求带键的槽位，插件已适配此要求（版本 1.0.1 中修复了缺少
options.key的问题）。 - 配置文件以
mcp-ui:为键存储在~/.dsh/settings.yaml中。
结语¶
dsh-mcp-ui 通过可视化界面简化了 MCP 服务器的配置流程，适合需要在 DSH Web 界面快速调整服务器参数的开发者。更多详情可访问 GitHub 仓库。
