Servidor MCP de Puppeteer configurable

Name: Configurable Puppeteer MCP Server
Author: afshawnlotfi

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:

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.
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: Puppeteer MCP Server

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.