dsh-streaming-mcp-bridge:DSH 实时流桥接插件

前言

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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜