前言¶
DSH 的插件生態強調「一切皆插件」。對需要給智能體接入 MCP 工具的開發者來說,手動整理服務器命令、傳輸方式、工具命名和啓動失敗行爲,容易出現配置差異。dsh-mcp-bridge 把一組常用 MCP 服務器打包爲 DSH 插件,並提供連接性驗證腳本,便於先確認服務器可連接,再交給模型使用。
這是什麼¶
dsh-mcp-bridge 是一個面向 DeepSeek Harness(dsh)的 MCP 服務器 bundle。一次安裝可提供 demo、memory、filesystem、GitHub、Playwright 和 remote HTTP 這幾類 MCP 服務器。
它使用 DSH 內置的 @deepseek-ai/dsh-mcp-client,支持 stdio 和 streamable-http、自動重連和 HMR hot-swap。每個整理過的服務器在 servers/ 下有機器可讀定義;scripts/verify-servers.mjs 會檢查每個服務器的連接性,使 “verified” 成爲一個可由腳本複覈的主張。
倉庫地址:
https://github.com/Edge-Echo/dsh-mcp-bridge
許可證:
MIT
核心功能¶
默認開啓的 demo 服務器¶
everything demo 服務器默認啓用,無需 API key。它提供 echo、add、long-running ops 和 tiny image 工具。安裝並重啓後,可以讓模型調用 mcp__everything__echo。
其他服務器¶
memory:提供會話內知識圖譜的 entities 和 relations。filesystem:支持文件讀取、寫入、搜索,範圍限定在顯式 roots。github:支持倉庫、issues 和 PRs,需要GITHUB_TOKEN。playwright:支持瀏覽器自動化,例如 navigate、click、screenshot。remote-http:支持接入自有或託管的 HTTP MCP server,需要 URL,可選 token。
工具在模型側以 mcp__<serverName>__<toolName> 形式出現。
安裝與啓用¶
前置條件:dsh 和 pnpm 需要在 PATH 中。dsh plugin 會轉發到 pnpm。若本機沒有 pnpm,可先執行:
npm i -g pnpm
安裝插件:
dsh plugin --profile web add dsh-mcp-bridge
如果從本地 checkout 安裝:
dsh plugin --profile web add ./dsh-mcp-bridge
重啓 profile:
dsh web
首次運行會通過 npx 下載服務器包,後續運行會緩存。
典型用法¶
重啓後,可以在對話中要求模型:
call the everything server's echo tool with hello
模型應使用 mcp__everything__echo。
如果要啓用註釋掉的預設,需要取消 profile 的 cordis.patch.yml 中對應服務器塊的註釋。
驗證與排查¶
在倉庫目錄中執行:
npm install
npm run verify
也可以直接執行:
node scripts/verify-servers.mjs
npm install 會引入 @deepseek-ai/dsh-mcp-client,它對應 MCP SDK。
如需調整每個服務器的超時時間,可設置:
VERIFY_TIMEOUT_MS=15000 npm run verify
排查單個服務器時,可執行:
node scripts/probe-server.mjs npx -y your-mcp-server
如果配置了 failOnStartupError: false,連接失敗時 entry 仍可能激活,但沒有可用工具。
適用場景與注意¶
適合需要快速給 dsh agent 接入一組 MCP 工具,並希望先做連接性檢查的開發者。
使用前需要注意:
- 插件以當前 dsh 進程權限運行,安裝前應檢查源碼和許可證。
filesystem需要顯式 root dir。github需要GITHUB_TOKEN。remote-http需要 URL,可選 token。playwright首次運行需要下載瀏覽器,體積較重,且被排除在 CI 外。- Node 引擎要求
>=22。 - 如果 profile 需要
@deepseek-ai/dsh-headless出現在dsh.profile.bundles中,headless verification 可能掛起;直接執行dsh plugin add @deepseek-ai/dsh-headless會因其未發佈依賴返回 404。 - DSH 社區目錄是獨立站點,與 DeepSeek 或幻方沒有官方從屬關係,不要把它理解爲官方應用商店。
鏈接¶
GitHub:
https://github.com/Edge-Echo/dsh-mcp-bridge