opencode-mcp-bridge
Coordinador autoalojado para conectar herramientas de IA con workers de OpenCode vía protocolo MCP sobre HTTP. Gestiona tareas asíncronas, verificación y limpieza sin acceso directo al shell.
Ficha actualizada 28 sept 2026, 12:16 · upstream 28 sept 2026, 12:00 · release v0.6.0
Qué es opencode-mcp-bridge
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa un servidor coordinador compatible con el protocolo Model Context Protocol (MCP) diseñado para integrarse con instancias autoalojadas de OpenCode. Actúa como puente entre clientes de IA (como Codex o Claude Code) y los workers de OpenCode en otra máquina, delegando tareas de repositorios o sistemas. El servidor coordina la ejecución, espera resultados y verifica el estado mediante herramientas específicas, manteniendo una separación estricta de responsabilidades: no reemplaza a OpenCode, sino que facilita su gestión remota.
La arquitectura soporta transporte HTTP con autenticación Bearer, evitando transportes locales como stdio para mayor seguridad. Ofrece dos endpoints principales: /worker-mcp (recomendado, con privilegios mínimos y sin acceso al shell) y /mcp (legado). Incluye puntos de control para salud, listas y métricas. El despliegue es compatible con Docker y Docker Compose, requiriendo recursos modestos (2 núcleos CPU, 2 GB RAM). La documentación cubre configuraciones para múltiples harnesses, incluyendo Cursor, VS Code y OpenHands.
La seguridad se centra en la gestión de tokens Bearer, que deben almacenarse en variables de entorno y nunca en archivos de configuración. El sistema permite flujos de trabajo asíncronos donde el cliente inicia una tarea y consulta su estado hasta completarse o caducar. Se recomienda usar siempre el endpoint /worker-mcp para evitar riesgos asociados a herramientas de ejecución directa como exec_run, que están deshabilitadas por defecto en este punto de conexión.
- Delegar tareas de desarrollo de código desde IDEs compatibles con MCP hacia workers de OpenCode remotos.
- Verificar y validar cambios realizados en repositorios Git mediante herramientas de coordinación centralizadas.
- Orquestar múltiples modelos de IA (Codex, Claude Code) para ejecutar flujos de trabajo complejos sin intervención manual.
- Gestionar el ciclo de vida de tareas asíncronas: catalogación, ejecución, espera y limpieza automática.
- Compatibilidad con protocolo MCP sobre HTTP Streamable, estandarizado para herramientas de IA modernas.
- Autenticación robusta mediante tokens Bearer gestionados en variables de entorno, sin exposición en archivos.
- Despliegue simplificado con soporte nativo para Docker y Docker Compose.
- Soporte multi-harness verificado para Cursor, VS Code, Gemini CLI y otros clientes MCP.
- Requiere despliegue propio del servidor de OpenCode; no funciona como servicio centralizado sin configuración.
- Algunos harnesses (como ChatGPT Developer Mode) tienen compatibilidad solo a nivel de protocolo, sin pruebas end-to-end completas.
- No soporta transporte local stdio, limitando su uso a entornos con acceso HTTP remoto seguro.
- El endpoint /mcp legado incluye herramientas como exec_run que pueden ser riesgosas si se habilitan incorrectamente.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar Docker o Compose para despliegue. Configurar OPENCODE_MCP_URL apuntando al dominio propio y OPENCODE_MCP_BEARER_TOKEN con un token seguro generado localmente. Evitar el uso del endpoint /mcp por defecto; preferir /worker-mcp para minimizar privilegios. No usar tokens en archivos de configuración. Verificar compatibilidad específica en docs/compatibility.md antes de producción.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.