Opencode in Chrome

Puente que da a OpenCode el control de tu Chrome, incluso cuando OpenCode corre dentro de un contenedor Docker. Expone 26 herramientas browser_* mediante el protocolo MCP: abrir pestañas, leer páginas, hacer clic, escribir, capturar pantalla, grabar GIF, inspeccionar consola y red.

OpenCode (Docker) ──MCP/HTTP──▶ server.js (host :8765) ──WebSocket──▶ extensión de Chrome ──CDP──▶ pestañas

Es una implementación propia e independiente, hecha con chrome.debugger y un servidor MCP mínimo en Node.

Requisitos

• Windows, macOS o Linux con Chrome (o un navegador Chromium con extensiones MV3).

• Node.js 18 o superior en el equipo donde corre Chrome.

• OpenCode con soporte de servidores MCP remotos.

Related MCP server: browserpilot-mcp

Instalación

1. Instala dependencias y arranca el servidor en el equipo con Chrome:

   npm install
   node server.js        # en Windows también: start.bat

   La primera vez genera token.txt (secreto; no lo compartas).

2. En Chrome abre chrome://extensions, activa Modo de desarrollador y usa Cargar descomprimida con la carpeta extension/.

3. En las opciones de la extensión pon el host (127.0.0.1:8765) y el contenido de token.txt. La insignia «ON» indica que está conectada.

4. Declara el servidor en la configuración de OpenCode (opencode.json del proyecto):

   {
     "mcp": {
       "servers": {
         "navegador": {
           "type": "remote",
           "url": "http://host.docker.internal:8765/mcp",
           "headers": { "Authorization": "Bearer <contenido de token.txt>" }
         }
       }
     }
   }

   Si OpenCode no es de Docker, usa http://127.0.0.1:8765/mcp. Reinicia OpenCode para que lea el cambio y comprueba con opencode mcp list.

5. Opcional: copia AGENTS.ejemplo.md como AGENTS.md en el proyecto para que el agente sepa usar las herramientas.

Herramientas

browser_screenshot admite fullPage, format (jpeg/png), save e inline. Las rutas de save, de los GIF y de browser_upload deben estar bajo /workspace/, que se traduce a la carpeta del equipo indicada por WORKSPACE_HOST (por defecto, dos niveles sobre este directorio).

Seguridad

• El agente solo ve y controla las pestañas del grupo naranja «OpenCode»; el resto del navegador queda fuera de su alcance.

• El token es obligatorio en el MCP y en el WebSocket.

• El servidor escucha en 0.0.0.0 para que un contenedor pueda llegar a él. Si no usas Docker, restríngelo con BRIDGE_HOST=127.0.0.1.

• browser_eval ejecuta JavaScript arbitrario en la página: úsalo solo con agentes y modelos en los que confíes.

• Guardar archivos está limitado a /workspace/.

Variables de entorno

Limitaciones conocidas

• browser_snapshot no recorre iframes de otro origen.

• La red y la consola se registran desde que la pestaña se abre con browser_open_tab o se controla por primera vez.

• Cada cambio en extension/ exige recargar la extensión en chrome://extensions.

Licencia

Apache License 2.0. Copyright 2026 Diego Velandia Barajas.