Configurable Puppeteer MCP Server

Name: Configurable Puppeteer MCP Server
Author: afshawnlotfi

@afshawnlotfi

Repository

About Configurable Puppeteer MCP Server

#puppeteer #browser-automation #mcp-server

Basic information

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\"}"
      }
    }
  }
}

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

FAQ from Configurable Puppeteer MCP Server

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.