Skip to main content
Glama

mcp-opencode

MCP local de 25 herramientas para que Codex/ChatGPT coordine OpenCode y sus agentes configurados.

Capacidades

  • opencode_setup: salud, agentes, proveedores, proyecto, Git y sesiones.

  • opencode_context: contexto agregado para planear: proyectos, agentes, modelos, sesiones, comandos, MCP y archivos.

  • opencode_agents: agentes disponibles.

  • opencode_projects / opencode_sessions: descubrimiento y continuidad de trabajo.

  • opencode_providers / opencode_commands / opencode_mcp_status: capacidades disponibles.

  • opencode_permissions / opencode_respond_permission: control explícito de pausas headless de OpenCode.

  • opencode_run: tarea síncrona con respuesta y diff.

  • opencode_reply: continuidad de una sesión existente.

  • opencode_fire: tarea asíncrona para paralelización.

  • opencode_parallel: fan-out controlado de hasta 12 tareas, con rechazo de escrituras concurrentes en el mismo directorio.

  • opencode_check / opencode_wait / opencode_wait_many: seguimiento de sesiones.

  • opencode_children / opencode_messages: auditoría de subagentes y continuidad.

  • opencode_fork / opencode_summarize: bifurcación y compactación de sesiones largas.

  • opencode_review: diff y estado de archivos.

  • opencode_file_status: estado de archivos antes/después.

  • opencode_abort: detención explícita de una sesión.

El servidor mantiene una interfaz de coordinación de alto nivel para el modelo y deja que OpenCode aplique sus propios permisos, agentes, herramientas MCP, AGENTS.md, modelos y subagentes.

Los listados de agentes se entregan compactados: conservan nombre, rol, modo, modelo, vista previa del prompt y resumen de permisos sin inyectar cientos de kilobytes de configuración en el contexto del modelo. Los modelos se seleccionan con provider/model, por ejemplo opencode-go/deepseek-v4-pro.

Las tareas, sesiones y operaciones de escritura requieren una ruta directory explícita para no modificar accidentalmente el propio MCP. Puedes definir OPENCODE_DEFAULT_DIRECTORY si quieres un proyecto predeterminado controlado.

Related MCP server: local-agent-mcp

Desarrollo

npm install
npm run check
npm run smoke
npm run runtime-smoke
npm start
npm run setup-startup

Configuración

Por defecto intenta iniciar OpenCode mediante el SDK oficial. Para conectarlo a un servidor ya iniciado:

$env:OPENCODE_BASE_URL = "http://127.0.0.1:4096"
$env:OPENCODE_AUTO_SERVE = "false"

Variables disponibles:

  • OPENCODE_BASE_URL

  • OPENCODE_SERVER_USERNAME

  • OPENCODE_SERVER_PASSWORD

  • OPENCODE_AUTO_SERVE (por defecto true)

  • OPENCODE_DEFAULT_AGENT (por defecto chatgpt-coordinator)

  • OPENCODE_DEFAULT_MODEL

  • OPENCODE_DEFAULT_DIRECTORY (opcional; debe ser una carpeta de proyecto existente)

Registro en Codex Desktop

Después de compilar, una entrada global típica en C:\Users\TU_USUARIO\.codex\config.toml es:

[mcp_servers.opencode]
command = "node"
args = ["C:\\Users\\TU_USUARIO\\Documents\\Programming-personal\\mcp-opencode\\dist\\index.js"]
cwd = "C:\\Users\\TU_USUARIO\\Documents\\Programming-personal\\mcp-opencode"
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 900
default_tools_approval_mode = "prompt"

Reinicia Codex Desktop y verifica /mcp. No se deben registrar secretos en este archivo.

Inicio automático de Windows

Este MCP usa STDIO, así que Codex debe ser su cliente y proceso supervisor. Para que quede disponible al iniciar sesión de Windows, ejecuta desde la raíz:

npm run setup-startup

El comando registra una tarea idempotente que resuelve la instalación actual y abre Codex Desktop al iniciar sesión; así sobrevive a actualizaciones de WindowsApps. Codex carga entonces la entrada mcp_servers.opencode y lanza el MCP cuando corresponda. No se deja un proceso STDIO huérfano sin cliente. Para quitarlo:

npm run remove-startup

Política de coordinación

El servidor entrega instrucciones MCP para que el modelo:

  1. consulte el contexto antes de delegar;

  2. use opencode_run para tareas bloqueantes;

  3. use opencode_fire solo para trabajos independientes;

  4. nunca permita escrituras concurrentes sobre los mismos archivos;

  5. consulte diff y pruebas antes de informar éxito.

Paralelización

opencode_parallel exige un directorio por tarea. Por defecto rechaza varias tareas con intención de escritura en el mismo directorio, porque las sesiones OpenCode comparten el árbol de archivos. Para cambios paralelos usa worktrees o carpetas distintas; allowSharedDirectory solo debe activarse cuando el usuario confirme que no habrá solapamiento.

Available Tools

25 tools
opencode_abortDetener sesión OpenCodeA

Detiene una sesión en ejecución. Úsalo solo cuando el usuario lo solicite o exista un bloqueo claro.

Inputs: directory (required), sessionId (required).

opencode_agentsListar agentes OpenCodeA

Devuelve los agentes primarios y subagentes disponibles, sus modelos y modos.

Inputs: directory.

opencode_checkConsultar progreso OpenCodeA

Devuelve estado, TODO, diff y mensajes recientes de una sesión.

Inputs: directory (required), sessionId (required).

opencode_childrenVer subagentes de una sesiónA

Devuelve las sesiones hijas creadas por OpenCode mediante Task, útil para auditar la delegación interna.

Inputs: directory (required), sessionId (required).

opencode_commandsListar comandos OpenCodeA

Lista comandos y workflows definidos globalmente o por el proyecto.

Inputs: directory.

opencode_contextContexto completo OpenCodeA

Agrega proyecto, agentes, proveedores, sesiones, comandos, MCP y estado de archivos para que ChatGPT pueda planear correctamente.

Inputs: directory.

opencode_file_statusEstado de archivos del proyectoA

Obtiene el estado de archivos que OpenCode ve en el proyecto para comprobar cambios antes y después de una tarea.

Inputs: directory (required).

opencode_fireLanzar tarea OpenCode en segundo planoA

Crea una sesión y dispara una tarea sin esperar. Úsalo para tareas independientes; devuelve un sessionId para seguimiento.

Inputs: prompt (required), directory (required), agent, model, +2 more.

opencode_forkBifurcar sesión OpenCodeA

Crea una sesión hija desde una sesión existente para explorar una alternativa sin perder el contexto original.

Inputs: directory (required), sessionId (required), title, messageId.

opencode_mcp_statusEstado MCP interno de OpenCodeA

Consulta los MCP que OpenCode tiene conectados y sus estados sin modificar configuración.

Inputs: directory.

opencode_messagesLeer mensajes de una sesiónA

Devuelve mensajes recientes de una sesión para continuidad, diagnóstico y evidencia.

Inputs: directory (required), sessionId (required), limit.

opencode_parallelCoordinar tareas OpenCode en paraleloA

Despacha hasta 12 tareas independientes. Rechaza por defecto escrituras concurrentes en el mismo directorio; usa worktrees/directorios distintos o permite la excepción explícitamente.

Inputs: tasks (required), allowSharedDirectory.

opencode_permissionsPermisos pendientes OpenCodeA

Consulta solicitudes de permiso pendientes y eventos recientes para resolver pausas de una sesión headless.

Inputs: directory.

opencode_projectsListar proyectos OpenCodeA

Lista los proyectos que OpenCode conoce. Úsalo para orientar una tarea cuando no se tenga claro el directorio.

Inputs: directory.

opencode_providersConsultar modelos OpenCodeA

Lista proveedores y modelos disponibles, incluido OpenCode Go, para seleccionar Flash o Pro con evidencia.

Inputs: directory.

opencode_replyContinuar sesión OpenCodeA

Envía una nueva instrucción a una sesión existente y devuelve respuesta, estado y diff actualizado.

Inputs: prompt (required), directory (required), sessionId (required), agent, +1 more.

opencode_respond_permissionResponder permiso OpenCodeB

Responde una solicitud headless con once, always o reject. Úsalo solo después de revisar el título y patrón del permiso.

Inputs: response (required), directory (required), sessionId (required), permissionId (required).

opencode_reviewRevisar cambios OpenCodeA

Obtiene la sesión, diff y estado de archivos para revisar el resultado antes de aceptarlo.

Inputs: directory (required), sessionId (required).

opencode_runEjecutar tarea OpenCodeA

Crea una sesión, delega una tarea al agente elegido, espera su respuesta y devuelve evidencia incluyendo diff.

Inputs: prompt (required), directory (required), agent, model, +2 more.

opencode_sessionsListar sesiones OpenCodeA

Lista sesiones recientes del proyecto, útil para retomar trabajo o auditar tareas en segundo plano.

Inputs: limit, directory.

opencode_setupPreparar contexto OpenCodeA

Comprueba salud, agentes, proveedores, proyecto, Git y sesiones activas. Úsalo antes de delegar una tarea nueva.

Inputs: directory.

opencode_statusEstado OpenCodeB

Consulta salud, sesiones ocupadas, MCP de OpenCode y estado Git del proyecto.

Inputs: directory.

opencode_summarizeCompactar sesión OpenCodeA

Resume/compacta una sesión larga usando un modelo explícito para conservar continuidad y liberar contexto.

Inputs: model (required), directory (required), sessionId (required).

opencode_waitEsperar tarea OpenCodeA

Espera una sesión asíncrona hasta que termine o alcance el tiempo límite y devuelve su evidencia.

Inputs: directory (required), sessionId (required), pollIntervalMs, timeoutSeconds.

opencode_wait_manyEsperar varias tareas OpenCodeA

Espera en paralelo varias sesiones previamente despachadas y devuelve el resultado de cada una.

Inputs: sessions (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 25 tools

    Disambiguation3/5

    Many tools have overlapping purposes, especially status/check/review which all inspect sessions and diffs. However, descriptions attempt to differentiate in specific ways, and the rest are more distinct.

    Naming Consistency4/5

    All tools share the consistent 'opencode_' prefix, but the suffix mixes verbs (run, fire, wait) and nouns (sessions, projects) without a strict verb_noun pattern. Still, the pattern is predictable and readable.

    Tool Count3/5

    At 25 tools, the server is on the heavy side for its scope. Several tools could likely be consolidated (e.g., status-like queries), but the count is not unreasonable for a full-featured session manager.

    Completeness4/5

    The tool set covers session lifecycle well: create, run, reply, fork, wait, abort, and monitor. Gaps include no explicit session deletion or update of provider configurations, but core workflows are present.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A project-local MCP bridge that allows Codex Desktop to plan tasks and OpenCode to execute them within the current project directory, with session reuse and native OpenCode background subagents.
      4
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables ChatGPT to work directly on local projects by reading files, editing code, running tests and commands, inspecting Git state, and managing durable workflows, with optional delegation to local Codex agents for complex tasks.
      28
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables ChatGPT conversations to directly inspect local workspaces and delegate coding tasks to a local Codex agent, with controlled concurrency, reusable sessions, and task/usage tracking.
      MIT