前言¶

DeepSeek Harness（命令名 dsh）是 DeepSeek AI 開源的智能體運行時，官方倉庫把原則寫成一句話：Everything is a Plugin（一切皆插件）。模型、工具、技能、會話、沙箱和界面都可以按 profile 增刪，不必改 harness 源碼。官方入門路徑是裝好 Node.js 後執行 npx @deepseek-ai/dsh web。目前仍是面向開發者的預覽版，接口還會變。

給智能體接外部工具時，Model Context Protocol（MCP）已經是常見約定：一邊是獨立進程裏的 MCP server，一邊是宿主裏的客戶端。DSH 自帶的橋接層是 @deepseek-ai/dsh-mcp-client：每個 server 寫成一條 Cordis 插件條目，發現到的工具會以 mcp__服務器名__工具名 的形式註冊到 ctx.tools。官方倉庫的 examples/mcp-memory 也寫得很清楚：DSH 只負責按 overlay 拉起 stdio 命令或連上 Streamable HTTP，不會替你下載 server、初始化數據庫、選模型或管另一套 HTTP 服務。結果就是：真正費時間的往往不是「會不會接 MCP」，而是自己拼一份 YAML，再逐個確認哪些 server 今天還能連上。

社區目錄 DeepSeek Harness 插件庫 收錄了由 Edge-Echo 維護的 dsh-mcp-bridge。它把一組精選 MCP server 收成可安裝的 bundle：默認只開零配置演示，其餘用註釋預設，連通性用倉庫腳本和 CI 檢查。需要先分清來源：這個目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不是官方應用商店。安裝命令以目錄頁原文爲準；功能邊界以倉庫 README、cordis.patch.yml、servers/*.json 和官方 dsh-mcp-client 說明交叉覈對。

這是什麼¶

dsh-mcp-bridge 是一款面向 DeepSeek Harness 的 MCP 全家桶插件，由 Edge-Echo 維護，源碼在 Edge-Echo/dsh-mcp-bridge，許可證爲 MIT，主要語言是 JavaScript。npm 包名同樣是 dsh-mcp-bridge，當前版本 0.1.3（2026-08-15 發佈），依賴 @deepseek-ai/dsh-mcp-client ^0.1.0-rc.6，要求 Node.js >=22。目錄頁將它歸在「記憶」分類——包內確實帶有會話內知識圖譜的 memory 預設——但插件本身不是單獨的記憶引擎，而是一組可啓用的 MCP server 定義。

截至 2026 年 8 月 18 日，目錄詳情頁與 GitHub 倉庫均顯示 4 星。目錄收錄日期爲 2026-08-15，倉庫最近一次推送也在同一天。GitHub topic 標了 dsh-plugin、deepseek-harness 和 mcp。

它解決的問題可以收成一句：不要從空白 YAML 開始猜哪些 MCP server 能在 dsh 裏跑起來。插件在 servers/ 裏爲每個精選 server 放一份機器可讀定義，scripts/verify-servers.mjs 會逐個做連通性檢查；GitHub Actions 工作流 verify.yml 在 main 的 push / pull request 上跑同一套腳本。橋接能力來自 DSH 內置客戶端：stdio 與 streamable-http、自動重連、改 patch 後 HMR 熱替換。

精選了哪些 MCP 服務器¶

倉庫 README 與 cordis.patch.yml 一致：默認只啓用 MCP 官方 everything 演示 server，其餘條目寫在註釋裏，按需取消註釋。六個條目的職責如下。

1、everything（默認開啓）

對應 @modelcontextprotocol/server-everything，零配置，本地 npx 拉起，不需要 API key。提供 echo、add、長任務、小圖片等演示工具。README 表格寫明 13 個工具；servers/everything.json 的驗證筆記寫：2026-08-15 在 Windows 上端到端跑通，模型調用 mcp__everything__echo，收到 Echo: hello。

2、memory（取消註釋即用）

對應 @modelcontextprotocol/server-memory，會話內知識圖譜，實體 / 關係 / 觀察，不需要額外環境變量。README 寫明 9 個工具；servers/memory.json 標註 verify.status 爲 verified，日期同樣是 2026-08-15。這是目錄把它分到「記憶」的直接原因。它是參考實現級別的 MCP memory server，不是 graph-memory 那類單獨的 DSH 記憶插件。

3、filesystem

對應 @modelcontextprotocol/server-filesystem，讀寫和搜索都限定在顯式授權的根目錄。最後一個參數必須改成真實存在的目錄，佔位路徑 C:/path/to/allowed/root 不能直接用。servers/filesystem.json 把狀態標成 needs-config；驗證筆記寫：給定真實目錄時可列出工具（筆記裏是 13 個）。README 表格寫的是 14 個工具。兩處數字不一致，啓用前以本機 verify 實際列出的工具爲準。

4、github

倉庫 / issue / PR 操作，需要環境變量 GITHUB_TOKEN。cordis.patch.yml 和 servers/github.json 都提醒：GitHub 官方 server 已遷到 github-mcp-server，當前預設仍寫 @modelcontextprotocol/server-github，啓用前要確認生態裏現在該用哪個包名。狀態是 needs-config，沒有寫驗證日期。

5、playwright

對應 @playwright/mcp，導航、點擊、填表、截圖一類瀏覽器自動化。首次運行會下載瀏覽器，比較重，CI 裏跳過。可設 PLAYWRIGHT_BROWSERS_PATH，或接受第一次下載。

6、remote-http

模板條目，transport: streamable-http，用來接自建或託管的 HTTP MCP server。示例 URL 是 http://localhost:3000/mcp，可選 Bearer token。README 把它寫成 DSH、Reasonix、CodeWhale 共用同一進程的入口：三者都是 agent harness，MCP 是共同語言。

工具呈現在模型側的名字與 Claude Code / Codex 的服務器限定形式相同。例如演示 server 的 echo 是 mcp__everything__echo。官方 dsh-mcp-client 還說明：目前只橋接 Tools，Resources 和 Prompts 沒有 harness 側消費者。

安裝與啓用¶

前置條件：本機 PATH 上要有 dsh 和 pnpm。倉庫 README 寫明 dsh plugin 會把命令轉發給 pnpm；沒有 pnpm 時可先執行 npm i -g pnpm。package.json 要求 Node.js >=22。

社區目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端裏運行即可：

dsh plugin add github:Edge-Echo/dsh-mcp-bridge

dsh CLI 會從 GitHub 解析插件並裝進當前配置。如需可復現安裝，按目錄頁說明固定 commit 哈希：

dsh plugin add github:Edge-Echo/dsh-mcp-bridge#<commit>

把上面的 <commit> 換成倉庫裏真實的提交哈希，不要留字面量。

倉庫 README 另外給出了針對 web profile、並走 npm 包名的寫法：

dsh plugin --profile web add dsh-mcp-bridge
# 本地 checkout：dsh plugin --profile web add ./dsh-mcp-bridge
dsh web        # 重啓 profile

兩種入口不要混着用猜測出來的 owner/repo。目錄頁以 github:Edge-Echo/dsh-mcp-bridge 爲準；README 以 npm 包名 dsh-mcp-bridge 爲準。插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。裝之前打開倉庫看源碼和 MIT 許可證。

典型用法¶

裝完並重啓 profile 之後，默認只有 everything 在跑。第一次調用會通過 npx 下載對應 server 包，之後走緩存。README 給的自檢方式是：讓模型「調用 everything 服務器的 echo 工具，傳 hello」，它應當使用 mcp__everything__echo。

若要啓用會話內知識圖譜，在當前 profile 的 cordis.patch.yml 裏取消 mcp-memory 那一段註釋。改 profile 的 patch 會走 HMR，文檔寫明無需重啓進程。對應條目形如：

- id: mcp-memory
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: memory
    transport: stdio
    command: npx
    args: ['-y', '@modelcontextprotocol/server-memory']

啓用 filesystem 時，把最後一個參數改成真實根目錄，不要照抄佔位路徑。啓用 github 前先準備 GITHUB_TOKEN，並再核一次當前應該安裝的包名。

自己加一個 stdio MCP server，推薦寫到 profile 的用戶 patch 層（同樣走 HMR）：

# $DSH_HOME/profiles/<name>/cordis.patch.yml
- id: mcp-myserver
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: myserver
    transport: stdio
    command: npx
    args: ['-y', 'your-mcp-server']
    env:
      YOUR_TOKEN: !!js process.env.YOUR_TOKEN

serverName 在同一進程內必須唯一，允許字符是 [A-Za-z0-9_-]，長度 1 到 32。遠程 HTTP 則改 transport: streamable-http，填寫 url 和可選的 headers。

想在本機複覈精選目錄，可以在倉庫裏執行：

npm install
npm run verify
# 等價於：node scripts/verify-servers.mjs

腳本會對每個 server 打印 PASS / SKIP / FAIL，任一失敗則退出碼非 0。單 server 超時可用 VERIFY_TIMEOUT_MS 調整；CI 裏用的是 45000。只排一個 server 時：node scripts/probe-server.mjs npx -y your-mcp-server。

適用場景與注意事項¶

適合已經在用 dsh、希望少寫一份 MCP YAML 的人：先確認演示通路，再按註釋打開 memory、filesystem 或遠程 HTTP。也適合要把同一套 HTTP MCP 同時給 DSH 和其他 harness 用的情況。不適合把本插件當成「官方 MCP 應用商店」，也不適合在沒看源碼的情況下，把 GitHub token、本機文件系統根目錄或瀏覽器自動化一次性全部打開。

使用時注意下面幾條，都來自目錄頁、倉庫文檔或官方客戶端說明，不是使用建議清單之外的推斷。

1、權限與信任。目錄頁寫明：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。filesystem 能讀寫你授權的根目錄；github 能碰倉庫和 issue；playwright 能驅動本機瀏覽器。只對源碼和許可證核過的倉庫授權，需要可復現時鎖定 commit。

2、默認失敗不致命。failOnStartupError 默認是 false：某個 server 連不上只記日誌、不註冊工具，插件條目仍會激活。看起來「裝上了」，模型側卻沒有對應 mcp__… 工具時，先查 profile 日誌。

3、驗證覆蓋面。CI 跑的是零配置那一檔；github、playwright、remote-http 在 catalog 裏是 needs-config 或明確排除。README 裏的「已驗證」指腳本對當前精選定義做過連通性檢查，不是對你機器上每一項配置的保證。filesystem 的工具數量，README 與 servers/filesystem.json 也不完全一致。

4、官方客戶端的能力邊界。@deepseek-ai/dsh-mcp-client 只把 MCP Tools 註冊進 ctx.tools。Resources、Prompts 目前沒有 harness 側消費者。stdio 子進程隨插件生命週期拉起和退出；HTTP 服務必須事先已經在跑。

5、Windows。README 寫：MCP SDK 用 cross-spawn，可以解析 .cmd shim，不需要單獨的 npx.exe。若用 dsh --profile "任務" 做 headless 驗證卻掛起，文檔要求 profile 的 dsh.profile.bundles 裏有 @deepseek-ai/dsh-headless；直接 dsh plugin add @deepseek-ai/dsh-headless 會因其未發佈依賴 404，需要手動加。缺它時插件樹能激活，但沒有 agent 消費任務。

小結¶

dsh-mcp-bridge 把 DSH 官方 MCP 客戶端和一組精選 server 定義捆在一起：一條命令裝上 bundle，默認只開 everything 做通路檢查，memory、filesystem、GitHub、Playwright 和遠程 HTTP 按註釋啓用。連通性檢查有倉庫腳本和 CI，但「能連上」不等於「你的 token、根目錄和瀏覽器下載都已經配好」。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-mcp-bridge/

GitHub：https://github.com/Edge-Echo/dsh-mcp-bridge