前言¶
在 DeepSeek Harness (DSH) 中,MCP 服务的配置通常写在 cordis.patch.yml 文件中。手动维护时,仅能通过配置文件确认服务是否存在,无法验证服务端是否真正连通。dsh-mcp-manage 插件在设置页面增加了一个“MCP 服务”管理入口,支持对服务器进行增删改查,并执行真实的 MCP initialize 握手以验证连接状态。
它是什么¶
这是一个静态 DSH 插件。它为 DSH 的设置界面新增了一个 MCP 服务管理页面,用于管理 cordis.patch.yml 中注册的服务器。插件会对每个服务发起真实的 MCP 初始化握手,以确认服务是否正常运行。
核心功能¶
- 管理页面:在 Settings 中新增“MCP 服务”页面。
- 增删改查:支持列出、添加、编辑和删除
cordis.patch.yml中的 MCP 服务器配置。 - 连接验证:运行真实的 MCP
initialize连接握手,检查每个服务是否连通。 - 持久化写入:将配置变更直接回写到
cordis.patch.yml。 - 自动协调:自动协调
dsh.profile.bundles。 - 传输支持:支持
streamable-http和stdio两种传输方式。
安装与启用¶
安装此插件必须使用 dsh plugin 包装器,不能直接使用 pnpm add。
dsh plugin --profile web add dsh-mcp-manage
安装完成后,需要重启 DSH(例如停止并重新启动 dsh web)以加载插件。重启后,进入 Settings → MCP 服务 即可使用该功能。如果页面未显示,请尝试硬刷新浏览器(Ctrl/Cmd + Shift + R)。
注意事项¶
- 依赖环境:需要 Node.js >= 18,以及
@deepseek-ai/cordis>= 4.0.1。 - 安装方式:必须通过
dsh plugin命令安装,以确保在重启后正确加载。 - 运行环境:这是一个静态插件,在 DSH 的正常平面运行,而非在沙盒中运行。
- 许可证:MIT 许可证。
结语¶
dsh-mcp-manage 解决了 DSH 开发者无法直观验证 MCP 服务连通性的问题。通过在设置中提供可视化的管理界面和真实的握手检测,它简化了服务的调试与维护流程。更多详情与源码,请参考 GitHub。