MIT ライセンスの Python 制御プレーン。DSH プラグインバンドル経由で DeepSeek Harness を制御された shell/ファイルシステム/リモート実行エージェントにする。コンテナ/VM を境界とし、OAuth・監査ログを備え、ファイアウォール越しの遠端マシンにも到達可能。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-09-02
ライセンス
MIT
01どんなタスクに使えるのか？
DeepSeek Harness から制御されたワークスペースに対して shell・ファイルシステム・Git・Playwright のタスクを実行する
スコープされた /workspace（shell・永続 shell・ファイルシステム・検索・パッチ・Playwright・監査・永続論理セッション・ファイルリンク・外向きリモートワーカーアクセス）
LLM に本物の制御された実行環境を渡したい DeepSeek Harness 利用者（おもちゃのサンドボックスではなく）
DSH の対話から、外向き接続しかできない NAT・ファイアウォール・HPC マシンを制御する
ワンタイムのリモートワーカー招待と通常ツールの省略可能な `machine` 引数により、DSH が外向き HTTPS でラボ/HPC/NPU ホストを操作可能に
厳格なファイアウォール背後や入站接続のないマシンで DeepSeek Harness を運用するプラットフォーム・基盤チーム
02DeepSeek Harness への導入方法
前提条件
- 同一ホストで既に稼働している通常の LSM HTTP/MCP サービス（バンドルは既存サービスにインストールされる）
- Python 3.11+（README に python-3.11+ バッジあり）
- Docker（quick start の `docker compose up -d` ランタイム用）
- インストール先の DeepSeek Harness プロファイル（README は `web` を使用）
- 公開/HTTPS 配備用の `.env` OAuth 設定：`LOCAL_SHELL_MCP_AUTH_MODE=oauth`・管理者 PIN・JWT シークレット
インストール手順
- 01
ホストで LSM サービスを起動：`mkdir -p workspaces/default` のち `docker compose up -d` し、`curl -i http://127.0.0.1:8765/healthz` で確認
$ curl -i http://127.0.0.1:8765/healthz
- 02
プラグインバンドルを DSH プロファイルにインストール：`dsh plugin --profile web add 'github:fwerkor/local-shell-mcp#main'`
$ dsh plugin --profile web add 'github:fwerkor/local-shell-mcp#main'
- 03
本番では Git 指定を移動する `main` ブランチではなく、レビュー済みのリリースまたはコミットにピン留めする
導入成功の確認
- ヘルスチェックが 200 を返す：`curl -i http://127.0.0.1:8765/healthz`
- DSH は `mcp__lsm__*` 名前空間配下でモデルツールを公開する
03DSH 統合と能力の範囲
dsh CLI 経由で本リポジトリを DSH プラグインバンドルとしてインストール。LSM 対応の Streamable HTTP ブリッジが完全な LSM ツール面（リモートワーカー含む）を DSH プロファイルに公開する。
ワークスペース shell とファイルシステム
制御されたルート配下の shell コマンド・ファイルパス・パッチ→shell / 永続 shell の出力、file read/write/edit/patch/grep/glob、および監査記録
コンテナ/VM 内でコマンドを実行workspace ルート配下のファイルを書き込み・パッチリモートワーカー
ワンタイム招待と通常ツールの省略可能な `machine` 引数→外向き HTTPS で接続する NAT/ファイアウォール/HPC/NPU/ラボ機器の制御
リモートワーカー機器上でコマンドを実行リモート側へ外向き HTTPS 接続を確立ブラウザ自動化（Playwright）
ブラウザセッション操作と省略可能な Playwright スクリプト→ページテキスト・PNG/PDF 証拠キャプチャ・完全な Playwright スクリプト実行
ヘッドレスブラウザを起動しページスクリプトを実行動的 MCP ツール
外部 MCP サーバー設定→`mcp_manage` / `mcp_tool_search` / `mcp_tool_inspect` / `mcp_tool_call` で漸進的に発見される外部ツール
最小 OS 環境で動的 stdio MCP サーバーを起動
04誰に向いているのか？使うべきでない場面は？
向いている用途
- LLM に本物の制御された実行環境を渡したい DeepSeek Harness 利用者（おもちゃのサンドボックスではなく）
- 厳格なファイアウォール背後や入站接続のないマシンで DeepSeek Harness を運用するプラットフォーム・基盤チーム
不向きな用途
- 接続されたモデルはコンテナ/VM を制御するとみなされる——想定セキュリティ境界はホストではなくコンテナ/VM。使い捨てのコンテナ/VM で実行し、ホストのルートや /var/run/docker.sock はマウントしないこと。
- 公開ネットワークで `LOCAL_SHELL_MCP_AUTH_MODE=none` のままサービスを公開してはならない。`oauth` を使い、長期凭证をモデルから見える環境変数に置かないこと。
05互換性・メンテナンス・セキュリティ上の注意
- 接続されたモデルはコンテナ/VM を制御するとみなされる——想定セキュリティ境界はホストではなくコンテナ/VM。使い捨てのコンテナ/VM で実行し、ホストのルートや /var/run/docker.sock はマウントしないこと。
- 公開ネットワークで `LOCAL_SHELL_MCP_AUTH_MODE=none` のままサービスを公開してはならない。`oauth` を使い、長期凭证をモデルから見える環境変数に置かないこと。
MIT · actively maintained (latest release v4.2.1, 2026-08-25)
06よくある質問
DeepSeek Harness の統合方式は？
本リポジトリ自体が DSH プラグインバンドルです。同一ホストで通常の LSM サービスを稼働させたうえで `dsh plugin --profile web add 'github:fwerkor/local-shell-mcp#main'` を実行すると DSH プロファイルにインストールされ、LSM 対応の Streamable HTTP ブリッジが完全な LSM ツール面を公開します。
複数の DSH 対話はどう隔離される？
各 DSH Session は安定した v4 論理セッション ID を受け取り、その Logical Session・アクティブ実行・Activity・ネイティブ Live Workspace ビューは他の DSH 対話から隔離され、DSH 側の MCP 伝送再構築後も維持されます。
DSH が見るツール名前空間は？
DSH は通常の `mcp__lsm__*` 名前空間配下でモデルツール（リモートワーカー・ブラウザツール・動的 MCP ツール含む）を見ます。
インストール時にバージョンをピン留めすべき？
本番では README の推奨通り、移動する `main` ブランチではなくレビュー済みのリリースまたはコミットに Git 指定をピン留めしてください。
公開しても安全？
想定セキュリティ境界はホストではなくコンテナ/VM です。OAuth を使い、使い捨てのコンテナ/VM で実行し、公開ネットワークで `LOCAL_SHELL_MCP_AUTH_MODE=none` のまま公開せず、長期凭证をモデルから見える環境変数に置かないでください。
07関連する DSH ワークフロー
archify
by tt-a1i
アーキテクチャ図、ワークフロー図、シーケンス図、データフロー図などを動きのある自己完結型 HTML として生成し、鮮明に書き出せるエージェントスキル
openviking
by volcengine
AI エージェント向けの自己進化型コンテキストデータベース。メモリ、知識 RAG、スキルを統合
nocobase
by nocobase
ビジネスシステムを高速構築できるオープンソースのAI＋ノーコードプラットフォーム。実績ある基盤の上でAIが動作するため、スピードと信頼性を両立できる。
learn-harness-engineering
by walkinglabs
Harness エンジニアリング入門チュートリアル。ゼロから一歩ずつ学べる
08データと出典
The repository root is also a DSH plugin bundle.
dsh plugin --profile web add 'github:fwerkor/local-shell-mcp#main'
The bundle uses an LSM-aware Streamable HTTP bridge and keeps the complete LSM tool surface, including `remote_manage`,…
DSH sees model tools under the normal `mcp__lsm__*` namespace.
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-09-02。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。