MCP Puppeteer Extra

🚀 Puppeteer-Extra MCP Server

A Model Context Protocol (MCP) server that enhances browser automation capabilities using Puppeteer-Extra and the Stealth plugin. This server enables large language models to interact with web pages in a more human-like manner and avoid being detected as automated operations.

✨ Features

• Enhanced browser automation capabilities
• Avoid anti-bot detection through Stealth mode
• Screenshot functionality for pages and elements
• Browser console logging and JavaScript execution
• Full set of interactive methods (click, fill, select, hover)

🧩 Components

Tools

• puppeteer_navigate

  • Navigate to any URL
  • Input: url (string)

• puppeteer_screenshot

  • Take a screenshot of a page or an element
  • Input:
    • name (string, required): Name of the screenshot
    • selector (string, optional): CSS selector for taking a screenshot of an element
    • width (number, optional, default: 800): Width of the screenshot
    • height (number, optional, default: 600): Height of the screenshot

• puppeteer_click

  • Click on an element on the page
  • Input: selector (string): Selector of the element to click

• puppeteer_hover

  • Hover over an element on the page
  • Input: selector (string): Selector of the element to hover over

• puppeteer_fill

  • Fill in an input field
  • Input:
    • selector (string): Selector of the input field
    • value (string): Content to fill in

• puppeteer_select

  • Select an element in a SELECT tag
  • Input:
    • selector (string): Selector of the element to select
    • value (string): Value to select

• puppeteer_evaluate

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

Resources

The server provides two types of resource access:

1. Console Logs (console://logs)

   • Text-formatted information from the browser console output
   • Contains all browser console messages

2. Screenshots (screenshot://<name>)

   • PNG images capturing page elements
   • Accessible via the specified screenshot name

🛠️ Development

📦 Installation

# Clone the repository
git clone <repository-url>
cd puppeteer_extra

# Install dependencies
npm install

# Copy the environment file
cp .env.example .env.development

🏃‍♂️ Local Run

# Development mode (non-headless browser)
npm run dev

# Production mode (headless browser)
npm run prod

🔨 Build

npm run build

🐳 Docker

Build Docker Image

docker build -t mcp/puppeteer-extra .

Run with Docker

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer-extra

⚙️ Configuration (for Claude Desktop)

Docker

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer-extra"]
    }
  }
}

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "MCPuppeteerExtra"]
    }
  }
}

📄 License

[Specific license information should be added here]