chrome-devtools-mcp: el servidor oficial que le da ojos de navegador a los agentes de IA
ChromeDevTools/chrome-devtools-mcp · 52.594★ · 4.695 forks
“Chrome DevTools for coding agents” — el servidor MCP (Model Context Protocol) oficial de Chrome DevTools que permite a los agentes de IA depurar, inspeccionar y auditar páginas web directamente en el navegador, en lugar de «programar con los ojos vendados».
Estado de los datos: verificado el 11 de septiembre de 2026 desde la API de GitHub, el registro de npm, Hacker News (Algolia), el blog oficial de developer.chrome.com y el código del repositorio (rama
main).

Qué es
chrome-devtools-mcp es un servidor MCP, escrito en TypeScript y bajo licencia Apache-2.0, que expone las capacidades de Chrome DevTools como herramientas que un agente de IA (Claude Code, Codex, Gemini CLI, Cursor, VS Code Copilot, etc.) puede llamar. El problema que resuelve está planteado explícitamente en el anuncio de lanzamiento: los agentes de código «no son capaces de ver qué hace realmente el código que generan cuando se ejecuta en el navegador» — están «efectivamente programando con los ojos vendados». Con este servidor, el agente puede abrir la página, capturar traces de rendimiento, leer la consola, inspeccionar las peticiones de red, hacer clic, rellenar formularios y tomar capturas de pantalla, y usar ese feedback para corregir su propio código.
En la práctica, el paquete de npm chrome-devtools-mcp incluye dos superficies: el servidor MCP (el caso de uso principal), que se conecta a un cliente MCP mediante stdio; y un CLI experimental (chrome-devtools) incluido en el mismo paquete, que actúa como cliente de un demonio en segundo plano. Es relevante porque, según Paul Irish (ver recepción), nació precisamente como respuesta a los costes de token del MCP.
No es un framework de automatización que lance un navegador aislado: su característica distintiva es que se conecta al Chrome que ya estás ejecutando (o a un navegador existente a través de --browser-url), conservando la sesión, las cookies y la autenticación.
Origen
Creadores / mantenimiento: el equipo detrás de Chrome DevTools y Puppeteer, en Google. Paul Irish (ex-miembro del equipo de DevTools, y que todavía lo es, según él mismo en Hacker News) lo confirma y lo defendió públicamente. Lanzamiento: el 23 de septiembre de 2025 se publicó como public preview (previsualización pública) a través de un post en el blog oficial de Chrome: «Chrome DevTools (MCP) for your AI agent» (developer.chrome.com/blog/chrome-devtools-mcp). Fecha de creación del repositorio: 11 de septiembre de 2025.
El anuncio se presentó como una respuesta directa al problema del agente «ciego». El tono del post fue de demostración práctica con prompts de ejemplo («Verifica en el navegador que tu cambio funciona», «¿Por qué no cargan unas imágenes en localhost:8080?», «Localhost:8080 carga lento, haz que cargue más rápido»). El equipo declaró que construiría el proyecto «incrementalmente» y pidió feedback público sobre qué capacidades añadir a continuación.
Dato curioso de la comunidad: Paul Irish reveló en Hacker News (2026) que el CLI standalone «recién había aterrizado» y que todavía no había sido anunciado oficialmente, advirtiendo: «¡Buenas noticias para todos los que somos conscientes de los desmesurados costes de token del MCP! El CLI aún no ha sido anunciado (perdón chicos), pero se está entregando en la última versión v0.20.0».
Filosofía y principios
El repositorio documenta sus principios de diseño en docs/design-principles.md. Son guías «aproximadas» que se aplican «con matices»: API agnóstica del agente (usar estándares como MCP, no bloquearse a un LLM); optimizado para tokens (devolver resúmenes semánticos: «LCP fue 3.2 s» es mejor que 50 000 líneas de JSON; los archivos son el sitio correcto para grandes volúmenes de datos); bloques pequeños y deterministas (dar herramientas componibles al agente — Click, Screenshot — no «botones mágicos»); errores auto-recuperables (devolver errores accionables que incluyan contexto y posibles correcciones); colaboración humano-agente (la salida debe ser legible por máquinas y por humanos); complejidad progresiva (herramientas simples por defecto pero con argumentos avanzados opcionales); y referencia sobre valor (para activos pesados, devolver una ruta de archivo o un URI, nunca el flujo de datos en bruto).

Estos principios explican el debate recurrente en Hacker News sobre el consumo de tokens: el equipo quiere ser eficiente, pero la naturaleza del estado de un navegador hace que el volumen de datos sea intrínsecamente alto.

Cómo funciona
Arquitectura
Modo servidor MCP: el cliente MCP (Claude Code, Codex, etc.) lanza npx -y chrome-devtools-mcp@latest por stdio. El servidor abre o se conecta a Chrome y expone las herramientas.

Modo CLI (chrome-devtools): el CLI es cliente de un demonio en segundo plano que usa sockets UNIX en Linux/Mac y named pipes en Windows. Comportamiento documentado: inicio automático (la primera vez que llamas a una herramienta, el CLI arranca en segundo plano el servidor MCP y el navegador si no están en marcha); persistencia (la misma instancia se reutiliza en comandos sucesivos, preservando el estado del navegador); y control manual (start, stop y status gestionan el proceso; start reenvía argumentos como --headless o --userDataDir, aunque no todos son soportados). Headless está activado por defecto; isolated también, salvo que se pase --userDataDir.

Herramientas (muestra del catálogo)
El repositorio mantiene un tool-reference.md extenso (~25 000 caracteres). Entre las herramientas verificadas en la documentación y el changelog: páginas/navegación (list_pages, new_page, navigate_page, take_screenshot, click, fill, select_option, upload_file con soporte multi-archivo desde v1.8.0, wait_for, evaluate_script); red (inspección de peticiones con URLs truncadas en la salida «concisa» desde v1.9.0, y retención limitada por navegación desde v1.7.0); consola (list_console_messages, con trazas de pila opcionales desde v1.8.0); rendimiento (performance_start_trace, con buffer de trazas por defecto alineado a DevTools de 1,2 GB desde v1.9.0, análisis de métricas como LCP); memoria (necesita --memoryDebugging: get_heapsnapshot_summary, get_heapsnapshot_edges, query_heapsnapshot, get_heapsnapshot_object_details, suite añadida entre v1.7.0 y v1.8.0); emulación (emulate, con validación de entrada desde v1.9.0); PWA (herramientas añadidas en v1.8.0); y screencast (opción de FPS añadida en v1.9.0).


Banderas / patrones de comando habituales
--browser-url=<url> (conectarse a un navegador ya en marcha, p. ej. el de Antigravity en el puerto 9222); --workspace=<dir> (repetible; limitar las herramientas de archivo a directorios concretos, no combinable con --allow-unrestricted-paths); --headless, --userDataDir, --screenshotFormat, --no-javascript-evaluation (que desde v1.9.0 también cubre navegaciones e initScripts); --memoryDebugging (habilita las herramientas de memoria); y --allow-unrestricted-paths (por defecto activo en el CLI desde v1.9.0).

El ecosistema
Mismos autores / org oficial (ChromeDevTools): el propio chrome-devtools-mcp incluye un marketplace de plugins para Claude Code (/plugin marketplace add ChromeDevTools/chrome-devtools-mcp) que empaqueta el servidor MCP más skills (v1.9.0 añadió el «Agent Plugins 1.0 package»). También existe un paquete de extensión de Gemini (gemini extensions install ... https://github.com/ChromeDevTools/chrome-devtools-mcp) que combina MCP + skills.
Proyectos de automatización de navegador para agentes (competidores/complementos nombrados en Hacker News): vercel-labs/agent-browser — «Browser automation CLI for AI agents» — 42 416 estrellas, 2 831 forks (creado 11 de enero de 2026); un usuario de HN (NiekvdMaas) señaló que funciona bien junto con DevTools MCP usando --auto-connect. remorses/playwriter — «Chrome extension & CLI to let agents control your browser» — 3 879 estrellas, 178 forks (creado 13 de noviembre de 2025); recomendado en el hilo principal de HN (zxspectrumk48) como alternativa que «se conecta a la sesión existente». pasky/chrome-cdp-skill — skill de agente para CDP, mencionada por aadishv en el hilo de HN (uso diario con Codex para gestionar una biblioteca musical local).
Alternativas de CDP/depuración: ScriptedAlchemy/devtools-debugger-mcp — «MCP server exposing full Chrome DevTools Protocol debugging: breakpoints, step/run, call…» — 347 estrellas. williamkapke/kapture — «Chrome DevTools Extension that enables browser automation through MCP» — 183 estrellas. benjaminr/chrome-devtools-mcp — «An MCP Server for Chrome DevTools, following the Chrome DevTools Protocol» — 308 estrellas (mismo nombre que el oficial; no es del equipo Chrome).
Paul Irish advirtió en HN que «la automatización de navegador + agentes es un espacio muy ocupado con muchos esfuerzos en paralelo», y distinguió que pasky/chrome-cdp-skill es un proyecto independiente, no una skill de DevTools MCP.

Estado oficial / semioficial
Oficial de Google / equipo de Chrome DevTools y Puppeteer: el proyecto está mantenido por el propio equipo de Chrome DevTools. Se lanzó como public preview oficial (23 de septiembre de 2025) desde el blog de developer.chrome.com, el dominio oficial de documentación de Chrome. Esto lo sitúa en una posición de referente de facto para el depurado de navegador por agentes que usan Chrome: es la implementación «de la fuente».
Adopción por clientes: el client-configurations.md documenta configuraciones para una lista muy amplia de clientes: Amp, Antigravity (Google), Bob (IBM), Claude Code, Cline, Codex (OpenAI), Command Code, Copilot CLI, Copilot / VS Code, Cursor, Devin CLI, Factory CLI, Gemini CLI, Gemini Code Assist, Grok Build CLI (xAI), JetBrains AI Assistant & Junie, Kiro, Katalon Studio, Mistral Vibe, OpenCode, Qoder, Qoder CLI, Visual Studio, Warp, Windsurf. VS Code, Cursor y Visual Studio ofrecen botones de un clic («Install Server» / «Install Plugin») para añadirlo directamente.
En la práctica, es el servidor que el propio equipo de DevTools recomienda a sus usuarios; su presencia con instaladores oficiales en VS Code/Cursor/Visual Studio y en los CLI de los principales agentes (Codex, Gemini, Copilot, Devin, Grok) indica un estatus de estándar de facto para «darle ojos de navegador a un agente en Chrome».
Guía rápida de uso
Instalación y primer arranque
Requisitos: Node.js (para npx/npm) y Chrome. El paquete es chrome-devtools-mcp.
Opción A — como servidor MCP (uso principal). Añade al cliente MCP:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["chrome-devtools-mcp@latest"]
}
}
}
Para conectar a un navegador ya en marcha, añade --browser-url=http://127.0.0.1:9222 a args. Instalación por CLI de algunos clientes: Claude Code (claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest), Codex (codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest), Gemini CLI (gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest), VS Code CLI (code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}').
Opción B — como plugin (MCP + skills) en Claude Code:
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins
(y reiniciar Claude Code; verificar con /skills). Prueba de humo documentada: en el agente, ejecutar el prompt «Please check the LCP of web.dev.»
Opción C — CLI (experimental). Instalar global:
npm i chrome-devtools-mcp@latest -g
chrome-devtools status # comprobar que la instalación funciona
Flujos de trabajo habituales
- Verificar un cambio en vivo: pide al agente «Verifica en el navegador que tu cambio funciona como esperas»; el agente usa
navigate_page+take_screenshot+ consola para comprobar. - Navegar por página (CLI):
chrome-devtools navigate_page 1 --url "https://google.com". - Captura de pantalla (CLI):
chrome-devtools take_screenshot 1 --filePath screenshot.png. - Auditoría de rendimiento: el agente llama
performance_start_tracesobre localhost y analiza métricas (p. ej. LCP alto). - Depurar errores de red/consola: «Algunas imágenes en localhost:8080 no cargan. ¿Qué está pasando?» → el agente inspecciona las peticiones de red y la consola.
- Depurar memoria (con
--memoryDebugging):get_heapsnapshot_summary→get_heapsnapshot_object_detailspara encontrar objetos que retienen memoria.
Configuración esencial
--browser-url— conectar a un Chrome ya en marcha (vs. lanzar uno nuevo). Clave para reutilizar sesión/autenticación.--workspace— limitar las herramientas de archivo a directorios concretos (seguridad). No combinable con--allow-unrestricted-paths.--headless— por defecto activo en el CLI; se puede desactivar para ver el navegador.--userDataDir— usar un perfil concreto; si se pasa, desactiva el modo isolated por defecto y permite reutilizar cookies/autenticación persistente.--memoryDebugging— habilita las herramientas de inspección de heap snapshots.
Trampas frecuentes y soluciones
- Consumo excesivo de tokens (la crítica más repetida): el estado de la sesión de navegador consume muchos tokens por naturaleza. Soluciones documentadas/comunitarias: usar el CLI (más eficiente), y en v1.9.0 se añadieron mejoras (URLs truncadas en salida de red, buffer de trazas alineado a DevTools). Comportamiento no trivial, no «bug».
- Instalación del plugin de Claude Code falla con
Failed to clone repository(p. ej. detrás de un firewall corporativo por HTTPS): el workaround es usar la instalación por CLI (claude mcp add ...) en su lugar. - Antigravity: con
--browser-urlel servidor no arranca el navegador automáticamente (se conecta al navegador integrado de Antigravity); hay que abrir el navegador primero. - Windows 11 con Codex: requiere configurar la ubicación de Chrome y subir el timeout de arranque en
.codex/config.toml(startup_timeout_ms = 20_000, más variablesSystemRoot/PROGRAMFILES). - Katalon Studio: necesita un proxy MCP (
mcp-proxy --transport streamablehttp --port 8080 -- npx -y chrome-devtools-mcp@latest) porque no soporta stdio directo. - Multipartes/archivos:
upload_filesoporta varios archivos desde v1.8.0; las herramientas de memoria requieren explícitamente la extensión.heapsnapshot/.heaptimeliney la bandera--memoryDebugging.
Integraciones y migración
Configuración lista para ~27 clientes. Instaladores de un clic en VS Code, VS Code Insiders, Cursor y Visual Studio; comandos CLI para Codex, Gemini, Copilot, Devin, Grok, Factory, Qoder, Mistral Vibe, OpenCode. Funciona junto a vercel-labs/agent-browser (vía --auto-connect); se puede usar playwriter como alternativa de «conectar a la sesión existente». Si ya automatizas con Playwright, DevTools MCP no sustituye la «conducción» (automatización) sino que añade la «depuración» (inspección de rendimiento/red/memoria con fidelidad de DevTools).
Métricas actuales
Datos de la API de GitHub y del registro de npm, fechados el 11 de septiembre de 2026:
| Métrica | Valor |
|---|---|
| Estrellas | 51 654 |
| Forks | 3 631 |
| Lenguaje principal | TypeScript |
| Licencia | Apache-2.0 |
| Fecha de creación | 11 de septiembre de 2025 |
| Versión latest (npm) | 1.9.0 |
| Último release | chrome-devtools-mcp-v1.9.0 (8 de septiembre de 2026) |
| Descargas npm (últ. semana) | 1 426 792 |
| Descargas npm (últ. mes) | 9 555 181 |
Top contributors (API GitHub, 12 listados en la primera página): OrKoN (375 contribuciones), dependabot[bot] (231), Lightning00Blade (139), browser-automation-bot (63), yulunz (39), szuend (27), dinfuehr (25), zyzyzyryxy (21). La API de GitHub confunde issues y PRs en el recuento open_issues_count, por lo que el total de «issues abiertos» no se cita como dato fiable por separado. Nota sobre suscriptores: la fuente de este artículo no consignó una cifra separada de subscribers_count (watchers reales) para este repositorio.
Recepción de la comunidad
Hacker News es la principal fuente de conversación. El hilo más grande — «Chrome DevTools MCP (2025)», ID 47390817 — llegó a 604 puntos y 234 comentarios (creado 15 de marzo de 2026; la URL apuntaba al post «debug your browser session»). Hilo del lanzamiento original: ID 45349829 (19 puntos, «Chrome DevTools MCP», 23 de septiembre de 2025).
Énfasis / elogios concretos:
- paulirish (equipo de DevTools): «DevTools MCP y su nuevo CLI están mantenidos por el equipo detrás de Chrome DevTools & Puppeteer y sin duda tienen un conjunto de funcionalidades más completo. Me espero que sea más fiable.»
- boomskats: «Lo llevo usando un tiempo, sobre todo con codex sobre opencode. Es más fiable y eficiente en tokens que otros MCP de protocolo de devtools que he probado. Mi caso de uso favorito e inesperado fue decirle a gemini que lo usara como un REPL de edición de SVG… también funciona muy bien con apps de electron.»
- NiekvdMaas: «También funciona bien junto con agent-browser (vercel-labs/agent-browser) usando —auto-connect.»
- speedgoose valora que la API MCP «puede ser útil también para humanos» y que es más amigable que la API de devtools previa.
- zxspectrumk48 y dataviz1000 comparten casos de éxito (re-engineering de APIs, interceptar peticiones).
Críticas / objeciones concretas:
- glerk: «Tened en cuenta que es un mega-voraz de tokens si pagáis vuestros propios tokens!»
- rossvc: «Llevo meses usando el DevTools MCP pero es extremadamente pesado en tokens. ¿Hay una alternativa que proporcione la misma cantidad de detalle al leer peticiones de red?»
- nerdsniper (respuesta): «Probablemente no está totalmente optimizado… pero los datos de estado/sesión del navegador siempre van a consumir una tonelada de tokens porque es una tonelada de datos. No hay realmente forma de evitarlo.»
- tonyhschu: «Yo hago algo similar con Playwright. Antes era un auténtico consumidor de tokens… construí un wrapper para volcar resultados a disco primero.»
- mmaunder (controversia): «Google está muy por detrás del CLI agéntico de coding… el MCP está muy muerto» → rsalus responde que «el MCP está muy lejos de estar muerto… los servidores MCP remotos centralizados son increíblemente útiles», y zeroxfe defiende «esto está muy lejos de la verdad» para entornos empresariales grandes. cheema33 plantea que el MCP «te hace pagar en uso de tokens aunque no estés usando el servidor», frente a los Agent Skills con «revelado progresivo».
- esperent: pregunta si esto es lo mismo que «Claude in Chrome» y menciona su preocupación de seguridad de que el agente vea tus datos.
Resumen neutro: la recepción es muy positiva en cuanto a fiabilidad y calidad (sobre todo por ser el producto del propio equipo de Chrome/Puppeteer), pero el punto de fricción recurrente y documentado es el consumo de tokens, que varios usuarios califican de «extremo» y que el propio equipo reconoce como inherente al volumen de datos de una sesión de navegador. De ahí el interés por el CLI como vía más eficiente en tokens.
Comparación con proyectos similares
| Proyecto | Estrellas | Enfoque | Diferencia clave |
|---|---|---|---|
| ChromeDevTools/chrome-devtools-mcp | 51 654 | Servidor MCP + CLI de depuración en Chrome | Oficial del equipo Chrome/Puppeteer; se conecta al Chrome existente; fuerte en traces, red, memoria |
| microsoft/playwright-mcp | 37 013 | Servidor MCP sobre Playwright | Basado en Playwright (multi-navegador); automatización más que depuración |
| vercel-labs/agent-browser | 42 416 | CLI de automatización para agentes | CLI de Vercel; compatible vía --auto-connect con DevTools MCP |
| remorses/playwriter | 3 879 | Extensión + CLI para controlar tu navegador | Corre snippets de Playwright en sesión con estado; extensión |
| browser-use/browser-use | 114 202 | Framework de agentes que usan el navegador | Framework/agentes completos, no solo un servidor MCP de depuración |
playwright-mcp es el competidor más directo en «MCP que controla un navegador» (Playwright en lugar de CDP directo), mientras que browser-use es una categoría superior (framework de agentes con navegador, mucho mayor adopción por estrellas pero distinto propósito). DevTools MCP se diferencia por ser la herramienta de depuración nativa de Chrome (traces de rendimiento, heap snapshots, consola, red con la fidelidad de DevTools) y por conectarse a tu sesión existente en lugar de lanzar un navegador aislado. En Hacker News se contrasta explícitamente: «Playwright vs. Chrome DevTools MCP: Driving vs. Debugging» — Playwright «conduce» (automatiza) mientras DevTools MCP «depura» (inspecciona en tiempo de ejecución).
Cómo contribuir
El repositorio documenta un proceso de contribución en CONTRIBUTING.md (~6 500 caracteres). Flujo: fork estándar de GitHub, ramas, pull request; el equipo pide seguir los principios de diseño (design-principles.md) al añadir funcionalidad. La documentación está separada en archivos individuales (cambio aplicado en v1.9.0), organizados en docs/ (tool-reference, configuration, cli, advanced-usage, client-configurations, troubleshooting, design-principles). Al añadir una nueva configuración de cliente se pide añadirla en orden alfabético en client-configurations.md. El equipo declara construir el proyecto «incrementalmente» y pide feedback de la comunidad. La actualización de agents.md para testing (v1.9.0) y la existencia de un browser-automation-bot en el top de contributors sugieren que el propio pipeline usa agentes de automatización de navegador.
Casos de uso
- Desarrolladores frontend/fullstack que usan agentes de IA (Claude Code, Codex, Gemini CLI, Copilot): el caso central. Permiten al agente ver el resultado en el navegador y autocorregir.
- Equipo de rendimiento / Core Web Vitals:
performance_start_trace+ análisis de LCP permite auditorías de rendimiento automatizadas, con la fidelidad y el buffer de DevTools. - Debuggers de fugas de memoria: la suite de heap snapshots con
--memoryDebuggingpermite inspeccionar retención de memoria directamente desde un agente, útil en SPAs/apps de Electron. - QA / automatización de tests: navegación, relleno de formularios, clics y capturas, junto con
upload_filemulti-archivo y herramientas de PWA. - Ingenieros de Electron / apps de escritorio web:
boomskatsdocumenta uso exitoso reverse-engineering y extendiendo apps de Electron. - Casos de uso creativos: el agente como «REPL de edición de SVG» para generar iconos por iteración de captura.
- Equipos que ya usan Chrome como navegador de trabajo: al conectarse a la sesión existente, se preserva autenticación y cookies.
- Usuarios que pagan sus propios tokens: deben sopesar el «token-hog» documentado; el CLI y las mejoras de v1.9.0 mitigan (pero no eliminan) el coste.
Recursos
- Repositorio: https://github.com/ChromeDevTools/chrome-devtools-mcp
- Blog oficial (lanzamiento): https://developer.chrome.com/blog/chrome-devtools-mcp
- Blog oficial (depurar tu sesión): https://developer.chrome.com/blog/chrome-devtools-mcp-debug-your-browser-session
- Skills/plugins oficiales:
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp; extensión de Geminigemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp - Registro npm: https://www.npmjs.com/package/chrome-devtools-mcp
- Changelog: https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/CHANGELOG.md
- Hilo principal HN: https://news.ycombinator.com/item?id=47390817 (604 pts, 234 comentarios)
- Hilo del lanzamiento: https://news.ycombinator.com/item?id=45349829
- Proyectos relacionados:
vercel-labs/agent-browser(42 416 ★),remorses/playwriter(3 879 ★),microsoft/playwright-mcp(37 013 ★),browser-use/browser-use(114 202 ★),ScriptedAlchemy/devtools-debugger-mcp(347 ★),pasky/chrome-cdp-skill
Nota: este informe combina el README y los archivos del repositorio, la API de GitHub, el registro de npm, Hacker News (Algolia) y el blog oficial de developer.chrome.com, consultados el 11 de septiembre de 2026. Las cifras cambian con el tiempo. No se pudieron extraer hilos de Reddit verificados en esta investigación (la API bloqueó la consulta), por lo que no se citan referencias de Reddit para evitar inventar fuentes.
Comentarios