在使用 DeepSeek Harness 开发智能体时,集成 Model Context Protocol (MCP) 服务器需要频繁检查连接状态和工具列表。直接在配置文件中管理既繁琐又容易出错。这个插件通过界面化的方式,解决了这一痛点,让你能在 Harness 的设置页面里直接扫描和管理本地注册的 MCP 服务器及其工具。
这是一个 DSH 插件,用于在 Harness 的设置页面中扫描和管理本地注册的 MCP 服务器及其工具。由 fatefgo2050 维护,采用 MIT 许可证。
核心功能¶
- 可视化列表:在「设置 → MCP 服务器」中列出当前 agent 可见的所有 MCP 服务器与工具。
- 全生命周期管理:支持添加、编辑、删除、启停和重连服务器。
- 传输协议支持:支持
streamable-http与stdio两种传输方式。 - 工具命名规范:工具统一以
mcp__<serverName>__<tool>格式提供给 agent。 - 宿主挂载处理:识别由 profile 的
cordis.patch.yml挂载的服务器,标记为「宿主挂载」并设为只读,避免重复连接。
安装与启用¶
该插件依赖官方公共包 @deepseek-ai/dsh-mcp-client。安装后需要重启 DeepSeek Harness 才能生效。
执行以下命令安装:
dsh plugin --profile desktop add fatefgo2050/dsh-mcp-scanner
典型用法¶
- 打开「设置 → MCP 服务器」。
- 点击「+ 添加 MCP 服务器」。
- 根据传输方式填写配置:
- streamable-http:填写 URL,可选 headers(例如
{"Authorization": "Bearer <token>"})。 - stdio:填写 command + args,可选 env。
- streamable-http:填写 URL,可选 headers(例如
- 添加后会自动等待连接结果,也可手动点击「刷新状态」。
配置存储¶
- 界面添加:在界面里添加的服务器会写入
$DSH_HOME/mcp-servers.json,你可以随时启停、编辑或删除。 - 宿主挂载:通过 profile 的
cordis.patch.yml挂载的服务器显示为「宿主挂载」,此处为只读模式;如需修改或移除,请直接编辑该配置文件。
安全与注意事项¶
- API 安全:
/mcp-scanner/api/*接口仅对 loopback (127.0.0.1) 开放;当 web 服务器对外暴露时,该 API 会返回 403。 - 命令执行风险:使用
stdio传输方式会执行本地命令,请只添加可信来源的服务器。 - 许可证:MIT。
总结¶
这个插件通过图形界面简化了 MCP 服务器的接入流程,适合需要在 DSH 中频繁调试 MCP 工具的开发者。
- 目录页:dsh-mcp-scanner
- GitHub 仓库:fatefgo2050/dsh-mcp-scanner