前言¶
DeepSeek Harness (DSH) 的 Agent Communication Protocol (ACP) 通常只返回最终结果,开发者无法实时观察代理的思考过程或工具调用。dsh-streaming-mcp-bridge 插件通过桥接 Harness 的实时 session.event 和 session.status 流,将思考、工具调用和状态更新暴露给外部客户端或集成工具。
是什么¶
这是一个社区维护的 DSH 插件(所有者:yabolee-kkk)。它将 Harness 的实时会话流桥接给外部 MCP 客户端或 ACP 适配器(如 Feishu),解决 ACP 静态响应无法展示过程的问题。
核心功能¶
- Streamable HTTP MCP:支持
notifications/progress,允许通过 MCP 协议实时查看任务进度。 - ACP Adapter for Feishu:实时向飞书推送思考、工具调用和状态更新,便于团队协作。
- Real-time Streaming:直接暴露
session.event和session.status。
安装与启用¶
作为 DSH bundle 插件安装到 Web profile:
dsh plugin --profile web add dsh-streaming-mcp-bridge
安装后启动 DSH Web:
dsh web
配置与鉴权¶
插件默认监听地址为 http://127.0.0.1:3477/mcp。建议设置 Bearer token 进行鉴权:
export DSH_STREAMING_MCP_TOKEN="your-secret-token"
可以通过 profile 的 cordis.patch.yml 覆盖 host、port、authTokenEnv 等配置项。
MCP 使用¶
使用 curl 验证 MCP 连接。首先初始化会话获取 Mcp-Session-Id,然后打开 GET SSE 流,最后调用 dsh_run_stream 方法查看 notifications/progress:
curl -X POST http://127.0.0.1:3477/mcp \
-H 'Authorization: Bearer TOKEN' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
ACP / Feishu 模式¶
插件支持 ACP 模式,可与 cc-connect 或 Feishu 集成。在 cc-connect 的配置中,将 type 设置为 acp,并指定 Harness JSON-RPC 运行时路径(默认使用 DSH_HARNESS_HOME 下的源码路径)。Feishu 展示会将每条状态、思考和工具调用放入独立代码块,最终回答放在代码块外。
安全与注意事项¶
- MCP 默认只监听
127.0.0.1,不要直接暴露到公网。 - 使用 Bearer token 鉴权。
dsh_run_stream会让 Harness 执行真实任务,仅对可信用户开放。- 需要安装 Node.js >= 22。
结语¶
该插件通过引入流式传输,填补了 DSH 生态中过程可见性方面的空白。查看源码或提交问题:GitHub