Chrome Control MCP

Control de Chrome visible y preciso para asistentes de IA. Local por diseño.

Inicio rápido · Catálogo de herramientas · Arquitectura · Seguridad · Verificación

La automatización activa permanece visible: el marco rosa, la insignia AI CONTROL y el cursor de agente pulsante muestran cuándo un asistente controla Chrome. Las capturas de pantalla orientadas al modelo ocultan esta superposición de forma predeterminada; las capturas de documentación pueden optar por mostrarla.

Por qué este proyecto

Las 43 herramientas MCP usan esquemas JSON estrictos. El proceso MCP de larga duración conserva la sesión y el estado de las referencias de elementos mientras Chrome sigue siendo un navegador normal controlado por el usuario.

Related MCP server: Chrome MCP Server

Verlo en acción

Ambas imágenes son resultados directos de browser_screenshot de la extensión en vivo, no maquetas.

Agradecimiento de pruebas: el UI Test Automation Playground de Inflectra y su repositorio de código abierto ofrecen escenarios de interacción con el navegador centrados y prácticos. Han sido de gran valor para probar la ruta completa de MCP a Chrome de este proyecto.

Inicio rápido

1. Instalar los requisitos de compilación

• Windows 10/11 x64, Linux x64 o macOS

• Google Chrome 116+

• CMake 3.25+

• Qt 6.5+ con componentes Core y Test

• Compilador de C++20: Visual Studio 2022, GCC o Clang

• Node.js 20.19+

2. Compilar y probar

npm ci
npm run build

Salida predeterminada:

Los usuarios de PowerShell pueden ejecutar ./scripts/build.ps1 -Configuration Release en su lugar. Ambas rutas compilan con advertencias como errores y ejecutan todas las suites de pruebas unitarias nativas y de extensión.

3. Preparar Chrome

npm run extension -- install

Abre chrome://extensions, activa el Modo de desarrollador, elige Cargar descomprimida y selecciona la carpeta que muestra el comando. Chrome requiere este único paso manual para una extensión descomprimida.

No se necesitan claves de firma, extensión empaquetada, cuenta de tienda, acceso de administrador ni directivas de empresa. La key pública en manifest.json solo fija el ID de la extensión descomprimida; no puede firmar software.

4. Conectar un asistente

Usa la ruta absoluta del ejecutable.

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Code usa el mismo ejecutable:

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

El transporte es JSON-RPC delimitado por nueva línea sobre stdio. El servidor no abre ningún puerto de escucha TCP.

Arquitectura

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

Un único ejecutable sirve como servidor MCP y como relevo de host nativo. El control del navegador pertenece a MCP porque necesita herramientas invocables, resultados de imagen, IPC endurecido y estado de sesión persistente. Una habilidad puede añadir flujos de trabajo, pero no reemplaza al servidor.

Modelo de seguridad

El control total es potente. Chrome Control MCP fija el origen de la extensión, limita y valida la IPC, autentica el relevo del mismo usuario/mismo ejecutable, rechaza referencias de elementos y coordenadas de captura obsoletas, acota los payloads principales y expone esquemas estrictos.

Windows usa una canalización con nombre protegida por ACL del usuario actual. Linux y macOS usan un socket Unix con modo 0600 dentro del directorio de ejecución privado, además de credenciales de par del sistema operativo.

Para uso solo de inspección:

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

El perfil de solo lectura expone 10 herramientas y rechaza de forma independiente llamadas mutables ocultas.

Verificación

Las puertas de control locales de Windows y Linux cubren actualmente:

• 9/9 suites nativas y de extensión con MSVC, GCC y Clang

• Advertencias como errores más clang-tidy y cppcheck exhaustivo

• Ejecuciones separadas de ASan+UBSan y TSan

• Escaneo de Gitleaks de todo el historial y auditoría de dependencias de npm

• 43/43 herramientas MCP en vivo mediante Chrome real en Windows

• Navegación, instantánea, escritura, clic y captura PNG en el Playground de UI público

• Ciclo de vida reversible de instalación/estado/desinstalación del host nativo

GitHub Actions compila y prueba Windows, Linux y macOS en cada push directo.

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

Comprobación en vivo del sitio público con PowerShell:

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

Consulta la evidencia exacta y los límites de las afirmaciones.

Identidad del proyecto

Anula el registro del host nativo del usuario actual con npm run extension -- uninstall y luego elimina la extensión descomprimida manualmente desde chrome://extensions cuando quieras retirarla.

Licencia

Publicado bajo la Licencia MIT. Copyright © 2026 Randy Northrup.