前言¶
DeepSeek Harness 采用插件化架构。要使用 Model Context Protocol (MCP) 服务器,开发者通常需要手动配置或编写脚本。meltartica/dsh-mcp-servers 是一个 DSH 插件,它将 MCP 服务器作为原生工具暴露,并提供了一套设置 UI、实时状态监控、自动重连以及通过本地文件或 WebDAV 进行备份/恢复的功能。
核心功能¶
该插件集成了 MCP 服务器连接与管理的客户端功能,主要特性如下:
- 多传输协议支持:支持 stdio、streamable http 和 legacy SSE 三种传输方式,在 UI 中通过统一的端点字段配置。
- 工具自动注册:工具自动注册为
mcp__<serverId>__<toolName>格式,遵循官方 MCP 客户端的命名规范。 - 状态监控与重连:提供实时状态指示点(绿色连接,红色失败),并在连接断开时自动尝试重连(带退避策略)。
- 测试与编辑:每张服务器卡片包含测试按钮,可探测连接与工具列表;支持编辑命令、参数、环境变量或 HTTP 头部。
- 备份与恢复:提供本地 JSON 导出/导入,以及 WebDAV 同步(支持 HTTPS 和 Basic Auth,可设置每日自动备份)。
安装与启用¶
使用 DeepSeek Harness CLI 进行安装:
dsh plugin --profile <name> add ./dsh-mcp-servers
dsh --profile <name>
安装后,启动 Harness,进入设置菜单的 MCP Servers 选项卡。
典型配置示例¶
在设置界面中添加服务器,点击 Test 验证连接,最后点击 Save 保存。
1. 配置 Stdio 服务器¶
适用于本地运行的 Node.js 进程。
- Type:
stdio - Command:
npx - Command Args:
-y和@modelcontextprotocol/server-everything(每行一个参数) - Env: 键值对,例如
API_KEY/your_token
2. 配置 HTTP/SSE 服务器¶
适用于远程 API。
- Type:
http或sse - URL:
https://example.com/mcp - Headers: 键值对,例如
Authorization/Bearer ...
3. 备份与恢复¶
在 Backup & Restore 标签页中,可以将当前服务器列表导出为 JSON 文件,或在需要时导入恢复。支持通过 WebDAV 进行云端同步,并可选每日 12:00 PM 自动备份。
注意事项¶
- Schema 限制:工具的输入 Schema 会经过白名单过滤,仅保留 Harness 支持的 JSON Schema 子集。不支持的关键字(如
minLength,format,anyOf等)会被丢弃。 - 渲染方式:MCP 返回的结果以文本形式渲染;图片或资源块会折叠为 JSON 或文本,不显示为富文本块。
- WebDAV 限制:WebDAV 仅支持 HTTPS 端点;URL 中不允许包含凭据,需单独输入;同步路由仅限回环访问。
- 运行权限:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证。
结语¶
该插件简化了 MCP 服务器在 DeepSeek Harness 中的接入流程,提供了完整的生命周期管理能力。更多详情与源码,请访问 GitHub 仓库。