Chrome MCP

Chrome MCP expone pestañas reales de Chrome a los clientes del Model Context Protocol sin copiar sesiones de navegador en otro motor. La extensión de Chrome controla las pestañas del perfil existente del usuario a través de chrome.debugger, mientras que un demonio local persistente coordina uno o más perfiles de Chrome y procesos MCP.

Arquitectura

MCP client ──stdio── MCP bridge ──authenticated HTTP── persistent daemon
                                                        │
                                                        ├── WebSocket ── Chrome extension/profile A ── tabs
                                                        └── WebSocket ── Chrome extension/profile B ── tabs

• Las pestañas son sesiones de navegador. Cerrar una sesión cierra su pestaña de Chrome.

• Cada instalación de la extensión representa un perfil/instancia de Chrome.

• El demonio asigna valores numéricos globales session_id en cada instancia conectada.

• El demonio persiste independientemente de los reinicios del cliente MCP y no tiene icono de bandeja.

• Las acciones usan el Protocolo Chrome DevTools a través de chrome.debugger, por lo que el JavaScript evaluado no está bloqueado por la CSP de la página.

• El estado de autenticación, las cookies, IndexedDB, los service workers, los certificados, las extensiones y la huella del navegador permanecen en el perfil original de Chrome porque no se requiere migración de sesión.

Related MCP server: monkeysee

Instalación

Se requiere Chrome 116 o superior.

bun install

Carga la extensión en cada perfil de Chrome que deba estar disponible:

1. Abre chrome://extensions.

2. Activa el Modo de desarrollador.

3. Elige Cargar descomprimida.

4. Selecciona el directorio extension de este repositorio.

5. Abre la ventana emergente de la extensión, asigna a la instancia un nombre reconocible y selecciona Usar como predeterminada cuando corresponda.

Chrome debe poder acceder a ws://127.0.0.1:55333. El demonio solo acepta WebSockets de extensiones procedentes de orígenes chrome-extension:// y solo se vincula a localhost.

Configuración del cliente MCP

{
  "mcpServers": {
    "chrome": {
      "command": "bunx",
      "args": ["-y", "@cypherpotato/chrome-mcp", "--mcp"]
    }
  }
}

Para una copia local después de bun link, apunta la configuración de MCP directamente al ejecutable enlazado en lugar de usar bunx:

{
  "command": "C:\\Users\\<user>\\.bun\\bin\\chrome-mcp-electron",
  "args": ["--mcp"]
}

CLI

chrome-mcp-electron --mcp
chrome-mcp-electron --daemon
chrome-mcp-electron --status
chrome-mcp-electron --stop-daemon
chrome-mcp-electron --help

--mcp inicia el demonio en segundo plano cuando sea necesario y luego sirve MCP a través de stdio. Cerrar el proceso de MCP no detiene el demonio ni desconecta las extensiones de Chrome.

Herramientas

Los nombres públicos de las herramientas y los esquemas de entrada coinciden con Browser MCP:

• browser_toggle_session

• browser_import_session

• browser_run_actions

• browser_get_context

browser_toggle_session({ "action": "start" }) abre una pestaña en la instancia predeterminada de Chrome. Cuando haya varias instancias conectadas, elige la predeterminada en la ventana emergente de la extensión. Las pestañas existentes notificadas por las extensiones también reciben valores session_id y pueden controlarse directamente.

browser_get_context enumera todas las instancias conectadas y sus pestañas. Las URLs se devuelven sin cadenas de consulta.

Múltiples instancias y perfiles de Chrome

Instala la extensión descomprimida por separado en cada perfil. Cada instalación crea un ID de instancia aleatorio estable que se almacena en ese perfil y se reconecta al demonio automáticamente. Los nombres de instancia no necesitan ser únicos, pero se recomienda que sean distintos.

El demonio reconcilia las pestañas después de reinicios de la extensión o del service worker. Una sesión permanece direccionable mientras su extensión propietaria esté conectada y la pestaña siga existiendo.

Capacidades

browser_run_actions admite la misma superficie de utilidades de navegador que Browser MCP:

• instantáneas y evaluación de JavaScript;

• clic, clic derecho, pasar el cursor, arrastrar, desplazarse y escribir;

• navegación;

• capturas de pantalla;

• registros de consola y de red;

• detalles de las solicitudes de red y cuerpos de respuesta cuando Chrome aún los conserva;

• emulación de viewport responsive y emulación de esquema de color;

• manejo de alertas, confirmaciones y prompts de JavaScript.

Limitaciones

• Chrome solo permite una conexión de depurador por pestaña. Cierra DevTools antes de controlar esa pestaña. Abrir DevTools puede desconectar la extensión.

• Las páginas internas de Chrome, las páginas de extensiones, Chrome Web Store y otros esquemas restringidos no pueden controlarse ni exponerse como sesiones de agente.

• La extensión debe estar instalada en cada perfil; un perfil no puede inspeccionar las pestañas de otro perfil.

• El permiso de depurador muestra una advertencia de Chrome mientras haya una pestaña adjunta.

• Los cuerpos de respuesta pueden caducar en el búfer de red de Chrome.

• La entrada táctil nativa y las API CDP de descarga internas del navegador no se exponen a través de chrome.debugger.

Desarrollo

bun run check
bun run test

El conjunto de pruebas utiliza clientes WebSocket simulados de extensiones para validar el ciclo de vida persistente del demonio, la autenticación, la reconciliación de pestañas/sesiones, las múltiples instancias, la selección de la instancia predeterminada, el enrutamiento de acciones y el comportamiento de reconexión sin abrir Chrome.

El protocolo interno está documentado en docs/protocol.md.