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