ディレクトリに戻る

dsh-harness-mcp-server

キュレーションリスト掲載メンテナンス: メンテナンス中

chushixixin/dsh-harness-mcp-server

DeepSeek Harness agent 能力を MCP server として公開(brain=Hermes, arms=Harness)

GitHub で見る
$ npm install @chushixixin/dsh-harness-mcp-server

16

スター

7

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-13

作成日

2026-08-15

最終プッシュ

MIT の TypeScript プラグイン。DeepSeek Harness の agent を MCP サーバーとして公開し、5 つのツール・構造化された結果・cwd 単位のセッション再利用を提供します。既定では localhost のみで認証なしです。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-16

ライセンス

MIT

01どんなタスクに使えるのか?

  • 外部の MCP クライアントから実コーディング作業を 1 件 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 のコンテキスト上限に達しがちな人、または無関係なタスクを並行実行したい人

02DeepSeek Harness への導入方法

前提条件

  • DeepSeek Harness のワークスペース — npm パッケージは `cordis.yml` patch 経由で Harness プラグインとして読み込まれるため、README はそのワークスペースから参照するよう指示しています
  • Harness を起動するシェルで `DEEPSEEK_API_KEY` を export しておく(`export DEEPSEEK_API_KEY=...`)
  • agent の bash コマンドがファイルを書き込む場合はホストに `bubblewrap` を導入する — `workspace-write` サンドボックスはこれがないと書き込みコマンドを拒否します
  • ソースからの方式を選ぶ場合:リポジトリを Harness ワークスペース内の `packages/mcp/harness-mcp-server/` に配置し(pnpm ワークスペースは `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 サーバーが `127.0.0.1:8090`(StreamableHTTP)で待ち受けていることです
  • `echo` ツールを呼び出す — README は MCP 接続確認の手段としてこれを挙げています
  • `harness_list_tools` が Harness に登録されたツール名の一覧を返す

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

DSH(Cordis)プラグイン — `cordis.yml` patch(`id: harness-mcp-server`、`name: '@chushixixin/dsh-harness-mcp-server'`)で Harness ワークスペースに登録し、`corepack pnpm dsh web --patch …/cordis.yml` で起動します。Harness 内部で StreamableHTTP の MCP サーバー(`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` サンドボックスに制限された書き込みと、呼び出しをまたいで cwd 単位に再利用される agent セッション

    ホストに `bubblewrap` がないとサンドボックスが書き込みコマンドを拒否するMCP セッションごとに独自の `McpServer` + transport を持ちます(MCP の `McpServer` は 1 つの transport にしか接続しないため)

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • 計画を担う「頭脳」を Hermes のようなクライアントに置き、Harness の agent とツール一式を実際に手を動かす「腕」として使いたいチーム
  • 大きなリファクタや無関係な複数タスクを並行実行している間も、クライアントの応答性を保ちたい場面
  • 長期のプロジェクト記憶を持ち、Harness の実行を毎回文脈付きで始め、記録を残したい agent
  • 主 agent のコンテキスト上限に達しがちな人、または無関係なタスクを並行実行したい人

不向きな用途

  • この待ち受けは認証なしの遠隔コード実行そのものです。README は `0.0.0.0` へのバインドや、認証・TLS・リバースプロキシを追加する前のインターネット / LAN への公開を明確に禁じています。
  • 認証と cwd の許可リストはいずれも任意です。`cordis.yml` の例では `authToken` と `workspaceRoots` がコメントアウトされているため、そのまま使うと両方とも設定されません。
  • bash は `workspace-write` サンドボックスで動くため、ホストに `bubblewrap` がないと書き込みコマンドが拒否され、ファイルを変更するタスクは完了できません。

05互換性・メンテナンス・セキュリティ上の注意

  • この待ち受けは認証なしの遠隔コード実行そのものです。README は `0.0.0.0` へのバインドや、認証・TLS・リバースプロキシを追加する前のインターネット / LAN への公開を明確に禁じています。
  • 認証と cwd の許可リストはいずれも任意です。`cordis.yml` の例では `authToken` と `workspaceRoots` がコメントアウトされているため、そのまま使うと両方とも設定されません。
  • bash は `workspace-write` サンドボックスで動くため、ホストに `bubblewrap` がないと書き込みコマンドが拒否され、ファイルを変更するタスクは完了できません。
  • 作者は日常の主力ではなくフォールバック用のツールと位置づけており、さらに新しい MCP セッションごとに独自の `McpServer` + transport を持ちます(1 サーバーにつき 1 transport)。
2026-08-132026-08-15v0.1.8

MIT · 最新リリース v0.1.8(2026-08-15T11:47:03Z)· 初期段階のプラグイン、MCP ツール 5 個

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 サーバーで、Harness の `ctx.agents`・`ctx.agentPresets`・`ctx.tools` を橋渡しします。外部クライアントが `agent_run` または `task_inbox` を呼ぶと、Harness は `standard` preset で `bash`・`fs`・`todo`・`web` を備えた agent を起動してタスクを実行します。

この MCP ポートを外部に公開しても安全ですか?

安全ではありません。README はこのサーバーが認証なしの遠隔コード実行を晒すと明記し、`0.0.0.0` へのバインドや、認証・TLS・リバースプロキシを追加する前のインターネット / LAN への公開を禁じています。`authToken`(Bearer)と `workspaceRoots`(cwd 許可リスト)はいずれも任意で、同梱の patch ではコメントアウトされています。

なぜ作者はフォールバック用ツールと呼んでいるのですか?

日常のコード編集は主 agent を直接動かすことを勧め、コンテキスト分離(クライアントのコンテキストを溢れさせる巨大なリファクタ)や無関係なタスクの並行実行のときだけこれを使う、という位置づけです。agent セッションは cwd 単位で再利用され、README は単発の `dsh headless` より約 15〜20 倍安いと見積もっています。

ファイル書き込みを伴うタスクの前に、ホスト側で何が必要ですか?

Harness 用に `DEEPSEEK_API_KEY` を export し、`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。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。