Configurable Puppeteer MCP Server

by afshawnlotfi
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports interaction with web elements using CSS selectors for operations like clicking, hovering, filling form fields, and capturing specific elements in screenshots.

  • Offers the ability to use Firefox instead of Chrome as the browser engine through custom Puppeteer configuration options.

  • Enables execution of JavaScript code in the browser context through the puppeteer_evaluate tool, allowing for dynamic interaction with web page content.

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

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.

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de protocolo de contexto de modelo que proporciona capacidades de automatización del navegador utilizando Puppeteer con opciones configurables a través de variables de entorno, lo que permite a los LLM interactuar con páginas web, tomar capturas de pantalla y ejecutar JavaScript en un entorno de navegador.

  1. Components
    1. Tools
    2. Resources
  2. Key Features
    1. Configuration
      1. Using with Custom Puppeteer Options
      2. Standard Configuration
    2. License
      ID: be53p5xcw8