返回目录

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 插件,绝不滥发。