AM

afshawnlotfi/mcp-configurable-puppeteer

Browser automation

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

4 stars 5 forks Качество 51 Тренд 12

Конфигурируемый Puppeteer MCP Server

Обзор

Сервер Model Context Protocol, который предоставляет возможности автоматизации браузера с помощью Puppeteer с настраиваемыми опциями. Этот сервер позволяет LLM взаимодействовать с веб-страницами, делать скриншоты и выполнять JavaScript в реальной среде браузера, с возможностью настройки параметров запуска Puppeteer через переменные среды. - Навигация по любому URL в браузере - Ввод: URL (струна) - Захват скриншотов всей страницы или конкретных элементов - Вводы: - имя (струна, требуется): Имя для скриншота - селектор (струна, необязательно): CSS селектор для элемента к скриншоту - ширина (номер, необязательно, по умолчанию: 800): Ширина скриншота - высота (номер, необязательно, по умолчанию: 600): Высота скриншота - - Нажмите элементы на странице - Ввод: селектор (струна): CSS селектор для элемента, чтобы щелкнуть - - Элементы зависания на странице - Ввод: селектор (струна): CSS селектор для зависания элемента - - Заполнить поля ввода - Вводы: - селектор (струна): CSS селектор для поля ввода - значение...

Обзор (машинный перевод)

Сервер Model Context Protocol, который предоставляет возможности автоматизации браузера с помощью Puppeteer с настраиваемыми опциями. Этот сервер позволяет LLM взаимодействовать с веб-страницами, делать скриншоты и выполнять JavaScript в реальной среде браузера, с возможностью настройки параметров запуска Puppeteer через переменные среды.

Компоненты

Инструменты

uppeteer navigate Навигация по любому URL в браузере

  • Ввод: [[Т0]] (струна)

puppeteer screenshot Захват скриншотов всей страницы или конкретных элементов

  • Входы:
  • [[Т1]] (струна, требуется): Название для скриншота
  • selector (струна, необязательно): селектор CSS для элемента для скриншота
  • width (номер, необязательно, по умолчанию: 800): Ширина скриншота
  • height (номер, необязательно, по умолчанию: 600): высота скриншота

puppeteer click

  • Нажмите элементы на странице
  • Ввод: selector (струна): CSS селектор для элемента, чтобы щелкнуть

** кукловод**

  • Зависимые элементы на странице
  • Ввод: selector (струна): селектор CSS для зависания элемента

uppeteer fill

  • Заполнить поля ввода
  • Входы:
  • selector (струна): селектор CSS для поля ввода
  • [[Т8]] (струна): значение для заполнения

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Configurable Puppeteer MCP Server

A Model Context Protocol server that provides browser automation capabilities using Puppeteer with configurable options. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment, with the ability to customize Puppeteer launch options through environment variables.

Components

Tools

  • puppeteer_navigate

    • Navigate to any URL in the browser
    • Input: url (string)
  • puppeteer_screenshot

    • Capture screenshots of the entire page or specific elements
    • Inputs:
      • name (string, required): Name for the screenshot
      • selector (string, optional): CSS selector for element to screenshot
      • width (number, optional, default: 800): Screenshot width
      • height (number, optional, default: 600): Screenshot height
  • puppeteer_click

    • Click elements on the page
    • Input: selector (string): CSS selector for element to click
  • puppeteer_hover

    • Hover elements on the page
    • Input: selector (string): CSS selector for element to hover
  • puppeteer_fill

    • Fill out input fields
    • Inputs:
      • selector (string): CSS selector for input field
      • value (string): Value to fill
  • puppeteer_select

    • Select an element with SELECT tag
    • Inputs:
      • selector (string): CSS selector for element to select
      • value (string): Value to select
  • puppeteer_evaluate

    • Execute JavaScript in the browser console
    • Input: script (string): JavaScript code to execute

Resources

The server provides access to two types of resources:

  1. Console Logs (console://logs)

    • Browser console output in text format
    • Includes all console messages from the browser
  2. Screenshots (screenshot://)

    • PNG images of captured screenshots
    • Accessible via the screenshot name specified during capture

Key Features

  • Browser automation
  • Console log monitoring
  • Screenshot capabilities
  • JavaScript execution
  • Basic web interaction (navigation, clicking, form filling)
  • Configurable Puppeteer options through environment variables

Configuration

Using with Custom Puppeteer Options

You can configure Puppeteer launch options by providing a JSON string in the PUPPETEER_ARGS environment variable. This allows you to customize browser behavior without modifying the server code.

Example: Using Firefox Instead of Chrome

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

Example: Configuring Browser Window Size

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}"
      }
    }
Открыть полный README на GitHub

Установка

npx -y github:afshawnlotfi/mcp-configurable-puppeteer
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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