Codex to OpenCode MCP Server

Ein kleiner lokaler MCP-Server (Model Context Protocol), mit dem Codex Programmierarbeiten an OpenCode delegieren kann. Er nutzt das offizielle MCP-Python-SDK, den stdio-Transport und einen asynchronen OpenCode-Subprozess.

Werkzeuge

opencode_execute

opencode_execute(
    task: str,
    working_directory: str,
    model: str | None = None,
    reasoning_effort: str | None = None,
    timeout: int = 1800,
)

Führt diesen Befehl ohne Shell aus:

opencode run --format json --dir <working_directory> --auto [--model <model>] [--variant <reasoning_effort>] <task>

reasoning_effort wird auf die anbieterspezifische Option --variant von OpenCode abgebildet. Übliche Werte sind minimal, low, medium, high und max, aber die verfügbaren Varianten werden vom ausgewählten Anbieter und Modell bestimmt. Der MCP-Server akzeptiert bewusst jeden nicht‑leeren Wert, statt eine anbieterspezifische Aufzählung zu erzwingen.

Beispiel:

opencode_execute(
    task="Implement uncertainty propagation and run the unit tests.",
    working_directory="C:\\path\\to\\NuSR",
    model="pinche_10/gpt-5.6-sol",
    reasoning_effort="high",
    timeout=1800,
)

Er liefert eine strukturierte Ausgabe, die Folgendes enthält:

• Erfolg, Timeout, Exit-Code und verstrichene Zeit;

• OpenCode-Sitzungs-ID und finale Zusammenfassung des Assistenten;

• abgeschlossene OpenCode-Toolaufrufe und Fehler;

• begrenzte stdout/stderr-Erfassungen;

• abschließend git status --short, git diff --stat und einen begrenzten Unified-Diff.

Die Git-Felder sind Momentaufnahmen nach der Ausführung. Sie können Änderungen enthalten, die bereits vor dem Aufruf vorhanden waren. Textinhalte nicht versionierter Dateien werden als Patches für neue Dateien dargestellt; binäre nicht versionierte Dateien werden mit Pfad und Größe gemeldet.

opencode_check

Ermittelt die konfigurierte OpenCode-Programmdatei und führt opencode --version aus, ohne die Umgebung zu verändern.

Related MCP server: Claude Code Manager WAN

Installation

Voraussetzungen: Python 3.11+, Git (optional für Diff-Berichte) und OpenCode.

git clone https://github.com/TAO-MINGYU/codex_to_opencode.git
cd codex_to_opencode
uv venv --python 3.11 .venv
uv pip install --python .venv\Scripts\python.exe -e ".[dev]"

OpenCode muss separat installiert und authentifiziert sein. Überprüfen Sie dies zuerst:

opencode --version
opencode auth list

Die OpenCode-Desktopanwendung und die OpenCode-CLI sind unter Windows getrennte Einstiegspunkte. Ein Aufruf von OpenCode.exe --version, der die GUI öffnet und nichts ausgibt, ist keine brauchbare CLI. Installieren Sie bei Bedarf die offizielle CLI:

npm install -g opencode-ai

Wenn opencode nicht im PATH liegt, setzen Sie OPENCODE_MCP_COMMAND auf den absoluten Programmdateipfad. Bei npm-Installationen unter Windows bevorzugen Sie die native Datei unter node_modules\opencode-ai\bin\opencode.exe; der Server erkennt und umgeht den opencode.cmd-Wrapper außerdem automatisch.

Codex verbinden

Fügen Sie den Server über die Codex-CLI hinzu, um die Konfiguration nicht von Hand bearbeiten zu müssen:

codex mcp add opencode --env OPENCODE_MCP_COMMAND=C:\path\to\opencode.exe -- C:\path\to\opencode-mcp\.venv\Scripts\python.exe -m opencode_mcp.server

Wenn OpenCode bereits im PATH ist, lassen Sie die Option --env weg:

codex mcp add opencode -- C:\path\to\opencode-mcp\.venv\Scripts\python.exe -m opencode_mcp.server

Überprüfen Sie anschließend die Registrierung:

codex mcp list

Starten Sie Codex nach der Änderung der MCP-Konfiguration neu. Der Server schreibt Protokollmeldungen nur nach stdout und sendet Logs an stderr, wie es für stdio-MCP-Server erforderlich ist.

Konfiguration

Wird die automatische Genehmigung deaktiviert, weist OpenCode Berechtigungen ab, die es nicht interaktiv abfragen kann:

$env:OPENCODE_MCP_AUTO_APPROVE = "false"

Debugging

Führen Sie die automatisierten Tests aus:

.venv\Scripts\python.exe -m pytest --cov=opencode_mcp --cov-fail-under=80
.venv\Scripts\python.exe -m ruff check .
.venv\Scripts\python.exe -m ruff format --check .

Führen Sie den Server unter dem MCP Inspector aus:

uv run --python 3.11 --with-editable ".[dev]" mcp dev src\opencode_mcp\server.py

Der Timeout des MCP-Tools sollte etwas länger sein als der an opencode_execute übergebene timeout; andernfalls könnte Codex die MCP-Anfrage abbrechen, bevor der Server OpenCode beenden und Diagnoseinformationen zurückgeben kann.

Sicherheitsmodell

opencode_execute ist bewusst ein schreibfähiges, potenziell destruktives Werkzeug. Es gewährt OpenCode dieselben Dateisystem- und Prozessrechte wie diesem MCP-Server. Die Implementierung:

• ruft für einen OpenCode-Aufgaben keine Shell auf;

• verlangt einen vorhandenen absoluten Arbeitsverzeichnis-Pfad;

• begrenzt die erfasste Ausgabe, um den Codex-Kontext zu schützen;

• zeigt den OpenCode-Prozessbaum beendet bei Timeout oder MCP-Abbruch;

• deaktiviert die automatische OpenCode-Aktualisierung während delegierter Läufe;

• markiert das MCP-Tool als nicht idempotent und potenziell destruktiv.

Verwenden Sie beim Delegieren nicht vertrauenswürdiger Aufgaben oder Repositorys ein eingeschränktes Betriebssystemkonto oder eine Sandbox.