前言¶
DeepSeek Harness(DSH)的設計理念是“一切皆插件”,Agent 在本地通過 DSH 調用文件、搜索等能力。Model Context Protocol(MCP)則是目前 Agent 工具調用的標準協議。現有的 dsh-mcp-client 解決的是“如何把外部 MCP 服務接入 DSH”的問題,而 dsh-mcp-bridge 解決的是反向問題:如何把 DSH 的能力暴露給外部的 MCP 客戶端(如 Claude Code、Codex)。
下面介紹這個插件的使用方法。
這是什麼¶
dsh-mcp-bridge 是一個將 DeepSeek Harness 工具集轉換爲標準 MCP 服務器(通過流式 HTTP)的插件。它允許任何 MCP 兼容的客戶端通過 HTTP 端點訪問 DSH 的工具。
- 所有者:liiiubai
- 類別:聯網工具
- 許可證:MIT
- Stars:1
該插件運行在 DSH 的沙箱與審批流程之上,確保外部調用經過安全驗證。
核心功能¶
- 標準 MCP 服務器:將 DSH 工具暴露爲 MCP 協議服務,支持流式傳輸。
- 多客戶端支持:可以被 Claude Code、Codex 或任何遵循 MCP 協議的客戶端/SDK 驅動。
- 安全控制:提供安全的允許列表機制,僅暴露低風險工具(read, glob, grep, web_search),並通過硬性拒絕列表防止危險命令(如 write, edit, pwsh)被誤用。
- 零依賴:純 JavaScript 實現,無需構建步驟。
- 原生沙箱:所有工具調用依然經過 DSH 的沙箱隔離與審批流程。
安裝與啓用¶
安裝過程通過 DSH 的插件命令完成。
- 執行安裝命令:
dsh plugin --profile <name> add github:you/dsh-mcp-bridge
*注意:請將 `<name>` 替換爲你實際使用的 DSH 配置文件名。*
- 插件會自動掛載一個
cordis.patch.yml配置文件,將服務端點掛載到/mcp。
典型用法¶
安裝完成後,配置允許列表並連接客戶端。
- 編輯你的
cordis.patch.yml,調整端點路徑和允許的工具:
- id: mcp-bridge
config:
path: /mcp # 端點路徑
allowlist: # 暴露給 MCP 客戶端的 DSH 工具
- read
- glob
- grep
- web_search
- 連接 Claude Code 或其他 MCP 客戶端:
claude mcp add --transport http dsh http://127.0.0.1:3080/mcp
客戶端將識別出以 `dsh_` 開頭的工具(例如 `dsh_read`, `dsh_glob`)。
適用場景與注意¶
- 適用場景:當你需要在非 DSH 環境下的 Agent(如 Claude Code)中直接使用 DSH 的文件讀取、搜索或網絡搜索能力時使用。
- 安全注意事項:
- 默認允許列表僅包含只讀、低風險工具。修改配置時請謹慎添加寫操作。
- 服務端點必須綁定在
127.0.0.1(迴環地址),不要綁定到0.0.0.0,除非你完全信任網絡環境。
- 雙向通信:
dsh-mcp-bridge目前只支持“外部客戶端 -> DSH”的單向暴露。如果你需要在 DSH 內部連接外部 MCP 服務器,請使用官方的@deepseek-ai/dsh-mcp-client插件。
結尾¶
dsh-mcp-bridge 讓 DSH 不僅能作爲工具使用者,也能作爲工具提供者融入 MCP 生態。通過簡單的配置和 HTTP 端點,即可在各類 Agent 中複用 DSH 的安全能力。