Configurable Puppeteer MCP Server

@afshawnlotfi

Repository

Basic information

About Configurable Puppeteer MCP Server

#puppeteer #browser-automation #mcp-server

Configurable Puppeteer MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Configurable Puppeteer MCP Server tools

Navigate to any URL in the browser

Capture screenshots of the entire page or specific elements

Click elements on the page

Hover elements on the page

Fill out input fields

Select an element with SELECT tag

Execute JavaScript in the browser console

Overview

What is Configurable Puppeteer MCP Server?

Configurable Puppeteer MCP Server is a Model Context Protocol server that provides browser automation capabilities using Puppeteer with configurable launch options. It enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment, with customization through environment variables.

How to use Configurable Puppeteer MCP Server?

Use the NPX command npx -y github:afshawnlotfi/mcp-configurable-puppeteer in your MCP client configuration. Optionally set the PUPPETEER_ARGS environment variable to a JSON string of custom Puppeteer launch options (e.g., to use Firefox or set viewport size).

Key features of Configurable Puppeteer MCP Server

Browser automation for web page interaction
Console log monitoring from the browser
Screenshot capturing of entire pages or elements
JavaScript execution in the browser console
Basic web interaction: navigation, clicking, form filling
Configurable Puppeteer options through environment variables

Use cases of Configurable Puppeteer MCP Server

Navigate to any URL and capture screenshots
Automate form filling and clicking on web pages
Execute JavaScript to extract dynamic content
Monitor browser console logs for debugging or data collection
Interact with web elements via hover, select, and evaluate commands

Frequently asked questions

How do I configure custom Puppeteer options?

Set the `PUPPETEER_ARGS` environment variable to a JSON string of Puppeteer launch options, such as `{"browser": "firefox"}` or `{"defaultViewport": {"width": 1280, "height": 800}}`.

What tools are available in this server?

Tools include `puppeteer_navigate`, `puppeteer_screenshot`, `puppeteer_click`, `puppeteer_hover`, `puppeteer_fill`, `puppeteer_select`, and `puppeteer_evaluate`.

How do I access screenshots after capturing them?

Screenshots are accessible via the resource `screenshot://<name>`, where `<name>` is the name provided during capture.

What resources does the server provide?

The server provides console logs at `console://logs` (text format) and screenshots at `screenshot://<name>` (PNG images).

How do I execute JavaScript in the browser?

Use the `puppeteer_evaluate` tool with the `script` input containing the JavaScript code to execute.

Comments

More Browser Automation MCP servers

Loadster

loadster

Loadster is a load testing, stress testing, and synthetic monitoring platform. Run Playwright, Browser Bots, and Protocol Bots to test and monitor your websites, web apps, and APIs. Loadster MCP gives your agents the abi