返回目錄

dsh-harness-mcp-server

精選清單收錄維護狀態: 維護中

chushixixin/dsh-harness-mcp-server

把 DeepSeek Harness 的 agent 能力暴露為 MCP server,讓任意 MCP 客戶端(如 Hermes)驅動 Harness 執行編碼任務。

前往 GitHub
$ npm install @chushixixin/dsh-harness-mcp-server

16

星數

7

Fork

TypeScript

語言

MIT

授權條款

2026-08-13

建立於

2026-08-15

最近推送

MIT 授權的 TypeScript 外掛程式,把 DeepSeek Harness 的 agent 能力公開為 MCP server:5 個工具、結構化結果、依 cwd 重複使用工作階段——預設只監聽本機,且不帶驗證。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-16

授權條款

MIT

01它能幫你完成什麼?

  • 從外部 MCP 使用者端把一項真實編碼任務交給 Harness agent,並在同一次呼叫中取回結構化結果

    帶 `sessionId`、`assistantText`、`toolCalls`、`toolResults`、`changes`、`verification`、`leftovers` 的結果,使用者端可據此判斷並記住這次執行

    把負責規劃的大腦(如 Hermes)留在使用者端、把 Harness 的 agent 與完整工具集當作動手的手臂來用的團隊

  • 不阻塞使用者端地把任務排進佇列,之後再取結果

    一筆帶任務文字、記憶脈絡與工作目錄的排隊任務,以及透過 `task_result` 輪詢回來的同一份結構化結果

    需要在大規模重構或多項無關任務平行執行時仍保持使用者端可回應的情境

  • 讓使用者端自己的長期記憶與 Harness 的編碼過程在多次執行之間形成閉環

    記憶以 `context` 注入每個任務,執行產出的 `changes` / `verification` / `leftovers` 再寫回使用者端記憶,供下一次任務使用

    具備長期專案記憶、希望每次 Harness 執行都帶著脈絡開始並留下紀錄的 agent

  • 把龐大的重構或多項無關任務卸載給 Harness,避免撐爆主 agent 的脈絡

    在 Harness 自己的 agent 工作階段裡完成的工作,且工作階段依 cwd 重複使用——README 估計比一次性 `dsh headless` 便宜約 15–20 倍

    遇到主 agent 脈絡上限的人,或希望無關任務平行執行的人

02如何將外掛接入 DeepSeek Harness?

先決條件

  • 一個 DeepSeek Harness 工作區——npm 套件是以 Harness 外掛程式的形式、透過 `cordis.yml` patch 載入,README 要求你在該工作區裡引用它
  • 啟動 Harness 的 shell 中已匯出 `DEEPSEEK_API_KEY`(`export DEEPSEEK_API_KEY=...`)
  • 當 agent 的 bash 指令需要寫入檔案時,主機需安裝 `bubblewrap`——`workspace-write` 沙箱缺少它時會拒絕寫入指令
  • 若選擇原始碼方式:把儲存庫複製到 Harness 工作區的 `packages/mcp/harness-mcp-server/`(pnpm workspace 比對 `packages/*/*`),並在 `tsconfig.host.json` / `tsconfig.base.json` 中登錄

安裝步驟

  1. 01

    執行 `npm install @chushixixin/dsh-harness-mcp-server`——README 推薦的 npm 方式

    $ npm install @chushixixin/dsh-harness-mcp-server

  2. 02

    在 Harness 工作區透過 `cordis.yml` patch 引用此外掛程式:插入 `id: harness-mcp-server`、`name: '@chushixixin/dsh-harness-mcp-server'`,設定 `http: true`、`port: 8090`、`host: 127.0.0.1`

  3. 03

    帶著該 patch 啟動 Harness:`corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml`

  4. 04

    改用原始碼方式:複製到 `packages/mcp/harness-mcp-server/`,執行 `corepack pnpm install`,在 `tsconfig.host.json` references 與 `tsconfig.base.json` paths 中登錄該套件,然後 `corepack pnpm exec tsc -b packages/mcp/harness-mcp-server` 與 `corepack pnpm run build:lib:host`

  5. 05

    把 MCP 使用者端指向 `http://127.0.0.1:8090/mcp`;Hermes 對應的指令是 `printf 'n\nY\n' | hermes mcp add harness_plugin --url http://127.0.0.1:8090/mcp`

驗證整合成功

  • README 提供的啟動指標是 MCP server 監聽在 `127.0.0.1:8090`(StreamableHTTP)
  • 呼叫 `echo` 工具——README 將它列為驗證 MCP 連線的方式
  • `harness_list_tools` 應回傳 Harness 已註冊的工具名稱清單

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

DSH(Cordis)外掛程式——透過 `cordis.yml` patch 註冊進 Harness 工作區(`id: harness-mcp-server`、`name: '@chushixixin/dsh-harness-mcp-server'`),並以 `corepack pnpm dsh web --patch …/cordis.yml` 啟動;在 Harness 內部執行一個 StreamableHTTP MCP server(`127.0.0.1:8090`),橋接 `ctx.agents` / `ctx.agentPresets` / `ctx.tools`,讓外部 MCP 使用者端驅動真正的 Harness agent

  • StreamableHTTP 上的 5 個 MCP 工具

    指向 `http://127.0.0.1:8090/mcp` 的 MCP 使用者端(README 以 Hermes 為例)→`echo`、`harness_list_tools`、`agent_run`、`task_inbox`、`task_result`

    依設定的 `host` / `port` 開啟 HTTP 監聽(patch 預設 `127.0.0.1:8090`)該監聽預設沒有驗證——README 直言這就是未經驗證的遠端程式碼執行
  • 同步執行 agent 任務

    交給 `agent_run` 的一項任務→Harness 以 `standard` preset 建立 agent,並回傳這次執行的結構化結果

    會實際啟動一個帶完整工具集(`bash`、`fs`、`todo`、`web`)的 Harness agent,在你傳入的 cwd 上作業
  • 非同步任務佇列

    透過 `task_inbox` 推入的任務文字、記憶脈絡與 cwd→一筆排隊任務,其結構化結果由 `task_result` 輪詢取回

    任務在 Harness 內部等待,直到有使用者端輪詢
  • 與呼叫端之間的記憶交接

    隨每個任務一起送出的記憶脈絡→每次結果中的 `changes`、`verification`、`leftovers`,可直接寫回使用者端記憶

  • 沙箱化 bash 與依 cwd 重複使用工作階段

    Harness agent 決定執行的 bash 指令→寫入受 `workspace-write` 沙箱限制,且 agent 工作階段依 cwd 在多次呼叫間重複使用

    主機沒有 `bubblewrap` 時沙箱會拒絕寫入指令每個新的 MCP 工作階段都各自擁有 `McpServer` + transport,因為一個 MCP `McpServer` 只連一個 transport

04適合誰?何時不該用?

適合

  • 把負責規劃的大腦(如 Hermes)留在使用者端、把 Harness 的 agent 與完整工具集當作動手的手臂來用的團隊
  • 需要在大規模重構或多項無關任務平行執行時仍保持使用者端可回應的情境
  • 具備長期專案記憶、希望每次 Harness 執行都帶著脈絡開始並留下紀錄的 agent
  • 遇到主 agent 脈絡上限的人,或希望無關任務平行執行的人

不適合

  • 該監聽埠等同未經驗證的遠端程式碼執行:README 明確禁止把它綁定到 `0.0.0.0`,也禁止在未加入驗證、TLS 與反向代理之前暴露到網際網路或區域網路。
  • 驗證與 cwd 白名單都是選用項——`cordis.yml` 範例中的 `authToken` 與 `workspaceRoots` 是註解狀態,原樣使用則兩者都沒有。
  • bash 執行在 `workspace-write` 沙箱裡;主機未安裝 `bubblewrap` 時沙箱拒絕寫入指令,需要變更檔案的任務就無法完成。

05相容性、維護與安全提醒

  • 該監聽埠等同未經驗證的遠端程式碼執行:README 明確禁止把它綁定到 `0.0.0.0`,也禁止在未加入驗證、TLS 與反向代理之前暴露到網際網路或區域網路。
  • 驗證與 cwd 白名單都是選用項——`cordis.yml` 範例中的 `authToken` 與 `workspaceRoots` 是註解狀態,原樣使用則兩者都沒有。
  • bash 執行在 `workspace-write` 沙箱裡;主機未安裝 `bubblewrap` 時沙箱拒絕寫入指令,需要變更檔案的任務就無法完成。
  • 作者將它定位為備援工具而非日常主力;另外每個新的 MCP 工作階段都會取得自己的 `McpServer` + transport,一個 server 只對應一個 transport。
2026-08-132026-08-15v0.1.8

MIT · 最新發布 v0.1.8(2026-08-15T11:47:03Z)· 早期外掛程式,5 個 MCP 工具

06常見問題

怎麼把 dsh-harness-mcp-server 裝進 DeepSeek Harness 工作區?

先用 `npm install @chushixixin/dsh-harness-mcp-server` 安裝,再依 README 提供的 `cordis.yml` patch 在 Harness 工作區裡引用它——patch 會插入外掛程式 `harness-mcp-server`,並寫上 `name: '@chushixixin/dsh-harness-mcp-server'`。README 沒有 `dsh plugin add` 這一步,啟動指令是 `corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml`。

Harness 內部實際執行的是什麼?

一個監聽 `127.0.0.1:8090` 的 StreamableHTTP MCP server,橋接 Harness 的 `ctx.agents`、`ctx.agentPresets` 與 `ctx.tools`。外部使用者端呼叫 `agent_run` 或 `task_inbox`,Harness 便以 `standard` preset 啟動一個帶完整工具集(`bash`、`fs`、`todo`、`web`)的 agent 執行任務。

把 MCP 連接埠暴露出去安全嗎?

不安全。README 說明該 server 暴露的是未經驗證的遠端程式碼執行,禁止綁定 `0.0.0.0`,也禁止在未加入驗證、TLS 與反向代理之前暴露到網際網路或區域網路。`authToken`(Bearer)與 `workspaceRoots`(cwd 白名單)都是選用項,在隨附的 patch 中是註解狀態。

為什麼作者稱它為備援工具?

日常修改程式碼時他建議直接驅動主 agent,只在需要脈絡隔離(會撐爆使用者端脈絡的超大重構)或平行執行無關任務時才用它。agent 工作階段依 cwd 重複使用,README 估計比一次性 `dsh headless` 便宜約 15–20 倍。

執行需要寫入檔案的任務前,主機要準備什麼?

需要為 Harness 匯出 `DEEPSEEK_API_KEY`,並安裝 `bubblewrap`——bash 執行在 `workspace-write` 沙箱裡,缺少它會拒絕寫入指令。另外注意每個新的 MCP 工作階段都會各自建立 `McpServer` 與 transport。

08資料與來源

  • 作者聲明github.comd174cea870aa…

    but it is a **Cordis app**, not something another agent can call.

  • 作者聲明github.comd174cea870aa…

    This plugin turns Harness inside-out: it starts a real **MCP server** (StreamableHTTP) *inside* Harness

  • 作者聲明github.comd174cea870aa…

    bridges Harness's core services — `ctx.agents`, `ctx.agentPresets`, `ctx.tools`

  • 作者聲明github.comd174cea870aa…

    corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。