Servidor MCP de Puppeteer configurable

Un servidor de Protocolo de Contexto de Modelo (MLP) que proporciona funciones de automatización del navegador mediante Puppeteer con opciones configurables. Este servidor permite a los LLM interactuar con páginas web, tomar capturas de pantalla y ejecutar JavaScript en un entorno de navegador real, con la posibilidad de personalizar las opciones de inicio de Puppeteer mediante variables de entorno.

Componentes

Herramientas

• titiritero_navegar

  • Navegue a cualquier URL en el navegador

  • Entrada: url (cadena)

• captura de pantalla del titiritero

  • 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 que se va a capturar en captura de pantalla

    • width (número, opcional, predeterminado: 800): Ancho de captura de pantalla

    • height (número, opcional, predeterminado: 600): altura de la captura de pantalla

• clic del titiritero

  • Haga clic en elementos de la página

  • Entrada: selector (cadena): selector CSS para el elemento en el que hacer clic

• titiritero_flotante

  • Elementos flotantes en la página

  • Entrada: selector (cadena): selector CSS para el elemento sobre el que se pasará el cursor

• relleno de titiritero

  • Rellene los campos de entrada

  • Entradas:

    • selector (cadena): selector CSS para el campo de entrada

    • value (cadena): Valor a rellenar

• titiritero_seleccionar

  • Seleccione un elemento con la etiqueta SELECT

  • Entradas:

    • selector (cadena): selector CSS para el elemento a seleccionar

    • value (cadena): Valor a seleccionar

• titiritero_evaluar

  • 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 la consola ( console://logs )

   • Salida de la consola del navegador en formato de texto

   • Incluye todos los mensajes de la consola del navegador.

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

   • Imágenes PNG de capturas de pantalla

   • Accesible a través del nombre de captura de pantalla especificado durante la captura

Related MCP server: Steel Puppeteer

Características principales

• Automatización del navegador

• Monitoreo de registros de la consola

• Capacidades de captura de pantalla

• Ejecución de JavaScript

• Interacción web básica (navegación, clics, llenado de formularios)

• Opciones configurables de Puppeteer a través de variables de entorno

Configuración

Uso con opciones personalizadas de Puppeteer

Puedes configurar las opciones de inicio de Puppeteer proporcionando una cadena JSON en la variable de entorno PUPPETEER_ARGS . Esto te permite personalizar el comportamiento del navegador sin modificar el código del servidor.

Ejemplo: usar Firefox en lugar de Chrome

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"browser\": \"firefox\"}"
      }
    }
  }
}

Ejemplo: Configuración del tamaño de la ventana del navegador

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}"
      }
    }
  }
}

Configuración estándar

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"]
    }
  }
}

También puedes especificar una rama, etiqueta o confirmación:

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer#main"]
    }
  }
}

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.