前言¶
在 DeepSeek Harness（DSH）中，插件设置页面通常只显示 MCP 服务器是否已挂载。然而，底层客户端在启动错误时默认不会中断进程，导致已挂载但未实际连接的服务器在 UI 中显示为“活跃”。这通常在智能体尝试调用工具时才会被发现。dsh-mcp-live-status 插件解决了这个问题，它直接在对话工具栏显示服务器的实时连接状态。
dsh-mcp-live-status 是什么¶
dsh-mcp-live-status 是一个 DeepSeek Harness 插件，由 felix-lj-ct 维护。它主要解决“已挂载但未连接”的假健康状态问题，帮助开发者快速识别 MCP 服务器的实际运行情况。
核心功能¶
该插件提供以下能力：
- 对话工具栏状态显示：在对话输入框的工具行中显示实时的连接状态药丸。
- 捕获假健康状态：能够识别出已挂载但从未成功连接的服务器。
- 点击查看详情：点击状态药丸可查看每台服务器的传输方式、工具数量以及失败原因。
- 零配置与只读：无需额外配置，插件以只读权限运行，仅用于状态监控。
安装与启用¶
安装该插件需要使用 web 配置文件，且 DeepSeek Harness 版本需为 0.1.0-rc.7 或更高。
dsh plugin --profile web add dsh-mcp-live-status
安装后，重启 web 配置文件实例即可生效。
典型用法¶
使用该插件需要满足以下条件：
- 环境要求：必须配置
web配置文件。 - 基础依赖：至少配置一个 MCP 服务器。
- 会话触发：状态药丸仅在会话存在时显示。
- 主机状态检查：可以通过以下命令检查主机端状态：
curl 127.0.0.1:3080/dsh-mcp-live-status/status
注意事项与限制¶
在使用过程中，请注意以下限制：
- 显示机制：状态显示依赖于会话，无会话时药丸不可见。
- 轮询机制：使用轮询而非推送机制获取状态。
- 工具与连接的区分：插件无法区分“服务器未连接”与“服务器已连接但工具数为零”。
- 权限范围：插件为只读模式，仅读取
loader、工具注册表和webServer路由。 - 安全处理：会对 MCP 服务器命令行中的密钥进行脱敏处理，防止泄露。
