Puppeteer

Puppeteer

Un servidor de Model Context Protocol que proporciona capacidades de automatización de navegador utilizando Puppeteer. Este servidor permite a los LLM interactuar con páginas web, tomar capturas de pantalla y ejecutar JavaScript en un entorno de navegador real.

Componentes

Herramientas

• puppeteer_navigate

  • Navegar a cualquier URL en el navegador
  • Entrada: url (cadena)

• puppeteer_screenshot

  • Capturar capturas de pantalla de toda la página o de elementos específicos
  • Entradas:
    • name (cadena, obligatorio): Nombre para la captura de pantalla
    • selector (cadena, opcional): Selector CSS para el elemento a capturar
    • width (número, opcional, predeterminado: 800): Ancho de la captura de pantalla
    • height (número, opcional, predeterminado: 600): Alto de la captura de pantalla

• puppeteer_click

  • Hacer clic en elementos de la página
  • Entrada: selector (cadena): Selector CSS para el elemento en el que hacer clic

• puppeteer_hover

  • Pasar el cursor sobre elementos de la página
  • Entrada: selector (cadena): Selector CSS para el elemento sobre el que pasar el cursor

• puppeteer_fill

  • Rellenar campos de entrada
  • Entradas:
    • selector (cadena): Selector CSS para el campo de entrada
    • value (cadena): Valor a rellenar

• puppeteer_select

  • Seleccionar un elemento con la etiqueta SELECT
  • Entradas:
    • selector (cadena): Selector CSS para el elemento a seleccionar
    • value (cadena): Valor a seleccionar

• puppeteer_evaluate

  • Ejecutar JavaScript en la consola del navegador
  • Entrada: script (cadena): Código JavaScript a ejecutar

Recursos

El servidor proporciona acceso a dos tipos de recursos:

1. Registros de consola (console://logs)

   • Salida de la consola del navegador en formato de texto
   • Incluye todos los mensajes de consola del navegador

2. Capturas de pantalla (screenshot://<name>)

   • Imágenes PNG de las capturas de pantalla tomadas
   • Accesibles mediante el nombre de captura especificado durante la captura

Características clave

• Automatización del navegador
• Monitoreo de registros de consola
• Capacidades de captura de pantalla
• Ejecución de JavaScript
• Interacción web básica (navegación, clics, relleno de formularios)

Configuración para usar el servidor Puppeteer

Aquí está la configuración de Claude Desktop para usar el servidor Puppeteer:

Docker

NOTA La implementación de Docker utilizará chromium sin interfaz gráfica, mientras que la versión NPX abrirá una ventana del navegador.

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "mcp/puppeteer"
      ]
    }
  }
}

NPX

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

Compilación

Compilación de Docker:

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.