claude-delegate-local-mcp

Claude Code が行う作業を、自分でホストするローカルモデルに委ねるための MCP サーバーです。

Bulk な、機械的な、読み取り中心の作業 — サブシステムの調査、テストの記述、機械的なリファクタリング、最初のパスでのレビュー — は、必要な推論が控えめな場合でもクラウドのトークンを消費します。このサーバーは、そうした作業の種類を自分のハードウエアへ移し、実質コストゼロで処理でし、Claude は本当に必要とする部分にだけ、そのままま使うことができます。

ステータス: 初期段。 設定、モデル・レジストリ、ドキュメント用のツール群は実装しテスト済みです。委任ツールそのものは、まだは構築されていません。現在の正確な状況は STATUS.md、今後の道のりは PLAN.md を参照してください。

動きの方

委任には2つの形があり、興味があるのは2つ目です。

• ワンショット — ファイルの内容はサーバー側で読み取って、単一のプロンプトの中にインラインされます。モデルは答え、バイト列が Claude のコンテキストに入ることはありません。レビュー、要約、説明に向いています。

• エージェント型 — ローカルのモデルは独自 read_file、write_file、run_bash を持ち、繰り返し処理を行います。コードを書き、テスト・スイートを実行し、実際の失敗を読い、直しても。う一度実行を繰り、必要なターンの数だけ繰り返します。それが ※、クラウド・トークンのコストゼロででき、そして、結果をClaude に返してレビューしてもらうます。

この2つ目のループこそが、シェルが存在している理由で、run_bash が bubblewrap により、ネットフがデフォルトでオフの空のルート、サンドボックスに閉い込てられて理由です。bubblewrap がなない境場、サーバーはシェル・コマンドの**実行を拒否*します、無制限には実行しません。

サーバーはまた、実際のプロセス終了コードを自ら取得し、モデルが答えの中で主張していることは別に、それとは別のとして報告します。モデルはコマンドの結果を誤って報告ることがあります。グラーンド・トゥースがなければ、自己検証のアイデーア自体が成立しなくなります。

Related MCP server: local-llm-mcp

これは何ではまったの

• クラウド・ルーサーバーではありません。同梱されているバックエンドの形式は1つ — OpenAI 互換です。Anthropic 互換のエンドポイントは、既存の継き目の後ろに予定された追加もので、現時点の機能ではありません。

• 違うモデルで Claude Code を実行ためのものではありません。委任するのはただであり、Claude Code は Claude Code のままで。

• 信頼できないコーヂのためのサンドボックスではありません。あなたが実行することを選んだモデルを、あなたが公開すると選んだワークスペースの中に閉じ込めるものです。

前提要件

• ローカルな OpenA- 互換のエンドポイントが必要です (vLLM が DeepSeek Flash を2台の DGX-Spark-class マシンで配信する構成にで楽し構築されましたが、特定のスタックに依存というわけではありません)。

• Python 3.11+。

• Linux、または Windows のWSL2。 — bubblewrap は Linux 専用で、Windows には簡单な代替手段がありません。そのため、Claude Code が Windows 側で動いていない場合にも、このサーバーは WSL2 側で実行されます。

インストール

git clone https://github.com/ComputerSaysNull/claude-delegate-local-mcp
cd claude-delegate-local-mcp

cp .env.example .env                  # then set DELEGATE_WORKSPACE_ROOTS
cp models.toml.example models.toml    # then set your endpoint

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
python scripts/install_hooks.py       # optional, gives the gate at commit time

.env と models.toml は意圖的に gitignore されています。これらはホスト名を指記するものなので、ホスト名は、住所と同じくらい確かにあなたのマシンを特定をしてしまうからです。

Windows の場合、サーバーが WSL2 にあるとき

wsl --install -d Ubuntu-24.04

Ubuntu の中では、前提せずに検証してください。次の2つは静かに失敗するためです。

sudo apt install -y bubblewrap python3 python3-venv git
bwrap --unshare-all --ro-bind /usr /usr --ro-bind /etc /etc --proc /proc \
      --dev /dev --tmpfs /tmp --symlink usr/bin /bin --symlink usr/lib /lib \
      --symlink usr/lib64 /lib64 -- /bin/echo ok      # must print: ok
getent hosts YOUR-HEAD-NODE                           # must resolve in WSL, not just Windows

usr/lib64 のシンボリックリンクは x86-64 では省略できません。ないと動的にリンクされたものは何も実行されず、しかもエラーは、存在しないローダーのせいではなく実行可能ファイルを責める形で表示されます。

Claude Code への登録

ネイティブ Linux:

{ "mcpServers": { "delegate-local": {
    "command": "claude-delegate-local-mcp",
    "timeout": 900000
} } }

Windows (サーバーは WSL2):

{ "mcpServers": { "delegate-local": {
    "command": "wsl.exe",
    "args": ["-d", "Ubuntu-24.04", "-e", "claude-delegate-local-mcp"],
    "timeout": 900000
} } }

timeout はミリ秒単位です。ウォールクロック上のデフォルトには余裕がありますが、長い委任の場合、別でにある30分の stdio のアイドル・タイムアウトに触れてしまことが súります。サーバーでは毎ターンに進捗ノーティスを出すことで、このタイムアウトを発火しないようにしています。詳細は docs/TROUNLESHOOTING.md を参照してください。

ドキュメントテーション

設定のデフォルト値が記されている場所は docs/CONFIgURATION.md だけです。このファイルは、デフォルトで定義されたコーダと生成されます。他の場所に同じデフォルト値を見付けたがあら、それはバグです — 基本的なスキームは CLAUDE.md を参照してください。

由々とライセンス

MIT ライセンスです。独立した実装ではなく、派生的な作品であり、かなりのコーダは [fegone/claude-code-degate-local](https://github.com/fegone/claude-code-deigate-local- ...) とそ [mixiccz](https://的・" から持ち始められました。

I KNOW — long construction. Let me tie it:

"かなりのコーダは fegone/claude-cod-delegate-local、およびそのフォーク mixicz からポートされたものです。どちらも MIT ライセンスです。サーバー側のコンテキストの先読み取りの発想は fjgbue/claude-delegate-dee-De? から来ています。どの機能がどこから来たかは NOTICE に機能ばいで記録されたいます。