MCP

Puppeteer MCP: abrir páginas en un navegador local y ver la consola

Para quien quiera navegar páginas en un navegador local real, leer la consola o guardar capturas. Este servicio puede alcanzar archivos locales e IP internas, y la única herramienta nombrada por completo en la evidencia es la navegación.

Official source · modelcontextprotocol/server-puppeteer

Install

npx -y @modelcontextprotocol/server-puppeteer

Para quién

Para quien necesite que un modelo abra páginas web en un navegador local real, lea la consola o deje capturas. La evidencia indica: es un servidor MCP de automatización de navegador con Puppeteer; el modelo puede interactuar con páginas, hacer capturas y ejecutar JavaScript en un navegador real.

Se ejecuta en su máquina, así que también puede alcanzar archivos locales e IP locales/internas. Conéctese solo si acepta esa frontera de privacidad y puede vigilar datos sensibles. La evidencia no lista clientes; solo cubre: ya tiene un cliente que puede configurar MCP y puede ejecutar npx.

La página oficial está en el árbol servers-archived. La evidencia no escribe por separado el estado de mantenimiento ni un reemplazo; no lo trate como un producto actual que sigue actualizándose.

Completar el primer intento en 3 minutos

Siga la ruta NPX de la evidencia. En la configuración MCP del cliente use:

"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]

No tome Docker como ruta principal al mismo tiempo. La evidencia solo añade: Docker usa Chromium sin cabeza; NPX abre una ventana del navegador.

Condiciones previas: Node/npx está instalado en local; el primer intento solo abre una página pública a la que tiene derecho, sin enviar formulario ni iniciar sesión. Tras arrancar, un navegador corre en esta máquina y puede acceder a archivos locales y direcciones internas.

Dónde configurar: la configuración de servidor MCP del cliente (comando y argumentos stdio). Tras guardar, reinicie o recargue el cliente.

Primera llamada de bajo riesgo: llame solo a puppeteer_navigate, escrito por completo en la evidencia, y navegue a la URL recién citada. La evidencia no da los campos de parámetros; el resumen de collect también menciona screenshot, click, hover, fill, select, evaluate, pero esos locators no están expandidos: no los llame en el primer intento.

Señal de éxito: en la ruta NPX debe ver una ventana de navegador local abierta y quedarse en la dirección que dio. Luego puede leer el recurso console://logs (salida de consola en texto) o screenshot://<name> (PNG). Si no aparece ventana, confirme primero que usa NPX y no Docker.

Casos de uso

Caso 1: Hacer que el modelo abra una página pública indicada. Llame a puppeteer_navigate. La evidencia solo garantiza «navegar a cualquier URL en el navegador»; no habla de tiempos de espera, redirecciones ni cookies locales. Lo que puede confirmar: la navegación ocurre en un navegador local real; no asuma una sesión cloud aislada.

Caso 2: Tras abrir la página, comprobar la consola o dejar una captura. La primera evidencia indica capturas y ejecución de JavaScript; la evidencia de recursos da console://logs (todos los mensajes de consola del navegador) y screenshot://<name> (PNG de una captura). La evidencia no nombra la herramienta de captura, cómo se genera <name> ni los parámetros de evaluate. Así que el segundo paso solo lee esos recursos, o se detiene en «la evidencia solo garantiza captura/JS»: no invente selectores ni scripts.

Límites de uso

Un navegador local puede acceder a archivos locales e IP locales/internas y sacar datos sensibles. NPX abre una ventana visible; Docker usa Chromium sin cabeza. El comportamiento difiere; no los mezcle y luego use una ventana como señal de éxito. La única herramienta nombrada por completo es puppeteer_navigate; las capacidades de interacción (clic, relleno) no tienen locator con parámetros y tienen efectos secundarios. Los recursos solo listan consola y capturas; no hay deshacer, limpieza de cookies ni cierre del navegador. La evidencia no da lista de clientes, modelo de permisos ni paquete de reemplazo tras el archivo.