Codex to OpenCode MCP Server

Un pequeño servidor local de MCP (Model Context Protocol) que permite a Codex delegar trabajo de programación en OpenCode. Usa el SDK oficial de MCP para Python, el transporte stdio y un subproceso asíncrono de OpenCode.

Herramientas

opencode_execute

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

Ejecuta este comando sin shell:

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

reasoning_effort se corresponde con la opción --variant específica del proveedor de OpenCode. Los valores comunes incluyen minimal, low, medium, high y max, pero las variantes disponibles las define el proveedor y el modelo seleccionados. El servidor MCP acepta a propósito cualquier valor no vacío, en lugar de imponer una enumeración específica del proveedor.

Ejemplo:

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,
)

Devuelve una salida estructurada que contiene:

• éxito, timeout, código de salida y tiempo transcurrido;

• el ID de la sesión de OpenCode y el resumen final del asistente;

• las llamadas a herramientas de OpenCode completadas y los errores de las llamadas;

• capturas acotadas de stdout/stderr;

• un git status --short final, un git diff --stat y un diff unificado acotado.

Los campos de Git son instantáneas posteriores a la ejecución. Pueden incluir cambios que ya existían antes de la llamada. El contenido de texto de los archivos sin seguimiento se representa como parches de archivo nuevo; los archivos binarios sin seguimiento se informan con su ruta y tamaño.

opencode_check

Resuelve el ejecutable de OpenCode configurado y ejecuta opencode --version sin modificar el entorno.

Related MCP server: Claude Code Manager WAN

Instalación

Requisitos: Python 3.11+, Git (opcional para informar diffs) y 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 debe instalarse y autenticarse de forma independiente. Verifícalo primero:

opencode --version
opencode auth list

La aplicación de escritorio de OpenCode y la CLI de OpenCode son puntos de entrada distintos en Windows. La invocación de OpenCode.exe --version que abre la GUI y no imprime nada no es una CLI utilizable. Instala la CLI oficial cuando sea necesario:

npm install -g opencode-ai

Si opencode no está en PATH, define OPENCODE_MCP_COMMAND con la ruta absoluta del ejecutable. En las instalaciones npm de Windows, prefiere el binario nativo incluido en node_modules\opencode-ai\bin\opencode.exe; el servidor también detecta y omite automáticamente el envoltorio opencode.cmd.

Conectar Codex

Añade el servidor a través de la CLI de Codex, lo que evita tener que editar la configuración manualmente:

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

Cuando OpenCode ya está en PATH, omite la opción --env:

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

Luego verifica el registro:

codex mcp list

Reinicia Codex después de cambiar la configuración de MCP. El servidor escribe mensajes de protocolo únicamente en stdout y envía los logs a stderr, como requiere para los servidores MCP stdio.

Configuración

Si se establece la aprobación automática en false, OpenCode rechaza los permisos que no puede solicitar de forma interactiva:

$env:OPENCODE_MCP_AUTO_APPROVE = "false"

Debug

Ejecuta las pruebas automatizadas:

.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 .

Ejecuta el servidor con MCP Inspector:

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

El timeout de la herramienta MCP debe ser ligeramente superior al timeout pasado a opencode_execute; de lo contrario, Codex puede cancelar la solicitud MCP antes de que el servidor pueda terminar OpenCode y devolver los diagnósticos.

Modelo de seguridad

opencode_execute es una herramienta con capacidad de escritura y, a propósito, potencialmente destructiva. Concede a OpenCode los mismos permisos de sistema de archivos y procesos que tiene el servidor MCP. La implementación:

• nunca invoca un shell para las tareas de OpenCode;

• exige una ruta absoluta existente del directorio de trabajo;

• limita la salida capturada para proteger el contexto de Codex;

• termina el árbol de procesos de OpenCode en ejecución si se agota el timeout o si la petición MCP se cancela;

• desactiva la actualización automática de OpenCode durante las ejecuciones delegadas;

• marca la herramienta MCP como no idempotente y de forma potencialmente destructiva.

Usa una cuenta de sistema operativo con privilegios restringidos o un sandbox cuando delegues tareas o repositorios no confiables.