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` に登録する
インストール手順
- 01
`npm install @chushixixin/dsh-harness-mcp-server` を実行(README が推奨する npm 方式)
$ npm install @chushixixin/dsh-harness-mcp-server
- 02
Harness ワークスペースから `cordis.yml` patch でプラグインを参照する:`id: harness-mcp-server`、`name: '@chushixixin/dsh-harness-mcp-server'` を挿入し、`http: true`、`port: 8090`、`host: 127.0.0.1` を設定
- 03
その patch を付けて Harness を起動:`corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml`
- 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` を実行
- 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(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)。
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 が作成される点にも注意してください。
07関連する DSH ワークフロー
dsh-our-free-model
by ebony-vinyl
ログインやAPIキーなしでDeepSeek V4.1 FlashやKimi K3などを利用できるとし、無料・無制限をうたうDeepSeek Harness向けプラグインです。
dsh-routing-suite
by yjh051108
DeepSeek Harness(dsh)向けのルーティング套件。まずランタイムインジェクターを導入し、続いてタスク認識型の推論モードルーター(P1〜P23 を計測済み)を組み込めます。
dsh-ops
by t-auto
Bash と PowerShell コマンドを実行し、ローカルファイルを検索および編集し、DSH から長期にわたるバックグラウンドジョブを管理します.
dsh-connect-workbuddy
by dingminhua
ローカルにサインインしたWorkBuddyモデルをDeepSeek Harnessへ接続。読み取り専用のクレジット概要とモデル管理を提供。
08データと出典
but it is a **Cordis app**, not something another agent can call.
This plugin turns Harness inside-out: it starts a real **MCP server** (StreamableHTTP) *inside* Harness
bridges Harness's core services — `ctx.agents`, `ctx.agentPresets`, `ctx.tools`
corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-16。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
