Repolode
AgentDeskAI

AgentDeskAI/browser-tools-mcp

Un servidor MCP y una extensión de Chrome que permiten a agentes de programación con IA acceder a registros de consola, tráfico de red, capturas de pantalla y auditorías de Lighthouse desde tu sesión de Chrome iniciada.

Estrellas
7,332
Forks
536
Issues abiertos
2
Último commit
hace 9 días

¿Qué es?

BrowserTools MCP permite que un agente de programación con IA inspeccione la página en la que estás trabajando. Se conecta a tu sesión actual de Chrome mediante una extensión de DevTools, para que sigas con la sesión iniciada, y transmite la salida de la consola, la actividad de red, capturas de pantalla y resultados de auditorías de Lighthouse a cualquier cliente compatible con MCP, como Cursor, Claude Code, Windsurf, Cline, Zed o Gemini CLI.

El proyecto está pensado para depurar aplicaciones en ejecución, no para escribir pruebas automatizadas. Los servidores orientados a la automatización, como Chrome DevTools MCP o Playwright MCP, controlan un perfil de navegador nuevo, por lo que hay que volver a iniciar sesión antes de depurar. BrowserTools, en cambio, lee la sesión que ya tienes abierta. Para configurarlo, basta con ejecutar un comando del servidor MCP y cargar la extensión incluida como extensión desempaquetada de Chrome; el propio servidor ejecuta el conector.

El servidor solo se enlaza a la interfaz loopback, requiere un token distinto en cada ejecución para la API HTTP y elimina de los datos capturados credenciales como los encabezados Authorization y Cookie, así como formatos de token habituales. Se hace seguimiento por separado de las pestañas que tienen DevTools abierto, y las cargas útiles grandes se ofrecen como recursos MCP para que solo se incorporen al contexto del agente cuando se soliciten.

Funciones clave

  • 01Transmite los registros de consola, los errores y las solicitudes de red de la pestaña actual de Chrome.
  • 02Captura pantallas y las devuelve al agente como imágenes.
  • 03Ejecuta auditorías de accesibilidad, rendimiento, SEO y buenas prácticas con Lighthouse.
  • 04Elimina las credenciales de los encabezados y las cadenas capturados antes de que salgan del navegador.
  • 05Hace seguimiento por separado de varias pestañas y permite que las herramientas se dirijan a una ID de pestaña específica.
  • 06Permite filtrar y paginar los resultados de los registros para mantener pequeñas las respuestas.

Casos de uso

  • Pedirle a un agente que diagnostique errores de consola en una página en la que tienes la sesión iniciada.
  • Depurar solicitudes de API fallidas o lentas mientras desarrollas una aplicación web en local.
  • Ejecutar auditorías de Lighthouse en una página sin configurar un perfil de pruebas aparte.
  • Pedirle a un agente que revise visualmente un cambio de interfaz leyendo una captura de pantalla de la página en ejecución.

Inicio rápido

  1. 1

    Añade el servidor MCP a la configuración de tu cliente MCP

    npx -y @agentdeskai/browser-tools-mcp@latest
  2. 2

    Descarga o clona el repositorio

  3. 3

    En chrome://extensions, activa el modo de desarrollador y carga el directorio chrome-extension sin empaquetar

  4. 4

    Abre Chrome DevTools (F12) en la página que quieras inspeccionar

Antes de usarlo

  • Se requiere Node 22.19 o posterior.
  • Firefox no está verificado y se considera no compatible.
  • La captura de red solo registra las solicitudes realizadas después de abrir DevTools.

En colecciones

Temas

Preguntas frecuentes

¿Qué es browser-tools-mcp?
Un servidor MCP y una extensión de Chrome que permiten a agentes de programación con IA acceder a registros de consola, tráfico de red, capturas de pantalla y auditorías de Lighthouse desde tu sesión de Chrome iniciada. BrowserTools MCP permite que un agente de programación con IA inspeccione la página en la que estás trabajando. Se conecta a tu sesión actual de Chrome mediante una extensión de DevTools, para que sigas con la sesión iniciada, y transmite la salida de la consola, la actividad de red, capturas de pantalla y resultados de auditorías de Lighthouse a cualquier cliente compatible con MCP, como Cursor, Claude Code, Windsurf, Cline, Zed o Gemini CLI.
¿browser-tools-mcp es gratuito? ¿Qué licencia tiene?
browser-tools-mcp es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿browser-tools-mcp sigue mantenido?
Mantenimiento activo. El último commit de browser-tools-mcp fue el 16 oct 2026.
¿Para qué puedo usar browser-tools-mcp?
Pedirle a un agente que diagnostique errores de consola en una página en la que tienes la sesión iniciada. Depurar solicitudes de API fallidas o lentas mientras desarrollas una aplicación web en local. Ejecutar auditorías de Lighthouse en una página sin configurar un perfil de pruebas aparte. Pedirle a un agente que revise visualmente un cambio de interfaz leyendo una captura de pantalla de la página en ejecución.
¿Cómo se instala browser-tools-mcp?
Añade el servidor MCP a la configuración de tu cliente MCP: npx -y @agentdeskai/browser-tools-mcp@latest Descarga o clona el repositorio En chrome://extensions, activa el modo de desarrollador y carga el directorio chrome-extension sin empaquetar Abre Chrome DevTools (F12) en la página que quieras inspeccionar
¿Dónde consigo browser-tools-mcp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/AgentDeskAI/browser-tools-mcp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados