claude-delegate-local-mcp

Ein MCP-Server, der es Claude Code erlaubt, Arbeiten an ein lokales Modell zu übergeben, das du selbst betreibst.

Massenhafte, mechanische, leseintensive Arbeit – sich in ein Subsystem einlesen, Tests schreiben, mechanische Refactorings, eine erste Durchsicht – kostet Cloud-Tokens, auch wenn der dafür nötige Denkaufwand gering ist. Diese Arbeit wird auf die eigene Hardware verlagert, wo sie praktisch nichts kostet, und Claude bleibt für die Teile, die es brauchen.

Status: frühe Phase. Konfiguration, Modell-Registry und die Dokumentationswerkzeuge sind eingerichtet und getestet. Die Delegationswerkzeuge selbst sind noch nicht gebaut. Den tatsächlichen Stand zeigt STATUS.md, die Route beschreibt PLAN.md.

So funktioniert es

Delegation kommt in zwei Formen, und die zweite ist die interessante:

• One-shot – Dateiinhalte werden serverseitig gelesen und in einen einzigen Prompt eingebettet. Das Modell antwortet; die Bytes gelangen nie in Claudes Kontext. Gut für Review, Zusammenfassung und Erklärung.

• Agentic – das lokale Modell bekommt ein eigenes read_file, write_file und run_bash und arbeitet iterativ. Es schreibt Code, führt deine Test-Suite aus, liest den tatsächlichen Fehler aus, behebt ihn und startet erneut – so viele Durchläufe wie nötig, zu keinerlei Cloud-Token-Kosten – und übergibt dann ein Ergebnis an Claude zur Begutachtung.

Diese zweite Schleife ist der Grund, warum die Shell existiert und warum run_bash von bubblewrap in eine Sandbox mit leerem Root-Verzeichnis und standardmäßig deaktiviertem Netzwerk eingeschränkt wird. Ist bubblewrap nicht verfügbar, verweigert der Server die Ausführung von Shell-Befehlen, statt sie ungeschützt auszuführen.

Der Server zeichnet außerdem die tatsächlichen Prozess-Exit-Codes selbst auf und meldet sie getrennt von dem, was das Modell in seiner Antwort behauptet. Modelle berichten Befehlsergebnisse fehlerhaft; ohne eine verlässliche Grundwahrheit bricht die ganze Idee der Selbstverifikation zusammen.

Related MCP server: cctx

Was es nicht ist

• Keiner Cloud-Router. Es wird genau ein Backend-Format ausgeliefert – OpenAI-kompatibel. Anthropic-kompatible Endpunkte sind eine geplante Ergänzung Es gibt eine nahtlose Schnittstelle, aber kein aktuelles Feature.

• Kein Weg, Claude Code gegen ein anderes Modell zu betreiben. Es delegiert Aufgaben; Claude Code bleibt Claude Code.

• Keine Sandbox für nicht vertrauenswürdigen Code. Es schränkt ein Modell ein, das du selbst ausführen wolltest, und zwar im Rahmen einer Arbeitsumgebung, die du selbst freigegeben hast.

Anforderungen

• Ein lokaler OpenAI-kompatibler Endpunkt (entwickelt wurde gegen vLLM, das DeepSeek V3 auf zwei DGX-Spark-Klassenmaschinen bereitstellt – aber nichts hängt von diesem spezifischen Stack ab).

• Python 3.11+.

• Linux oder WSL2 unter Windows – bubblewrap gibt es nur für Linux, und es gibt kein günstiges Windows-Pendant. Der Server läuft daher auch dort, wo Claude Code selbst nicht läuft.

Installation

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 und models.toml bleiben bewusst von Git ignoriert: Sie nennen einen Host, und der Hostname identifiziert deine Maschine ebenso eindeutig wie eine Adresse.

Unter Windows mit dem Server in WSL2

wsl --install -d Ubuntu-24.04

Dann wechsle in Ubuntu – und verifiziere, statt einfach anzunehmen, denn zwei davon scheitern still:

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

Der Symlink usr/lib64 ist unter x86-64 nicht optional: Ohne ihn läuft nichts, das dynamisch gelinkt ist, und die Fehlermeldung beschuldigt das ausführbare Programm statt der fehlenden Ladebibliothek.

Bei Claude Code registrieren

Natives Linux:

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

Windows, Server in WSL2:

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

timeout wird in Millissekunden angegeben. Der Standardwert ist großzügig bemessen (an der Wanduhr), aber eine lange Delegation kann den separaten 30-minütigen stdio-Idle-Timeout auslösen – der Server sendet pro Runde Fortschritts-Benachrichtigungen, damit das nicht passiert. Siehe docs/TROUBLESHOOTING.md.

Dokumentation

Keine Konfiguration wird woanders als docs/CONFIGURATION.md belegt, und diese Datei wird aus dem Code erzeugt, der sie definiert. Falls du eine Wiederholung an anderer Stelle findest, ist das ein Bug – CLAUDE.md erklärt das Schema.

Herkunft und Lizenz

MIT. Eine abgeleitete Arbeit, keine unabhängige Umsetzung: Ein erheblicher Teil des Codes wurde von fegone/claude-code-delegate-local und dessen Fork mixicz portiert, beide MIT. Die Idee des serverseitigen Kontext-Vorabrufs stammt von fjgbue/claude-delegator-deepseek-mcp. NOTICE hält fest, was woher stammt, Merkmal für Merkmal.