Puppeteer Extra Stealth

🚀 Puppeteer-Extra MCP Server

A Model Context Protocol (MCP) server that uses Puppeteer-Extra and the Stealth plugin to enhance browser automation capabilities. This server enables LLMs to interact with web pages in a more human-like manner and avoid being detected as automated programs.

✨ Features

• Implement enhanced browser automation with Puppeteer-Extra.
• Avoid bot detection through Stealth mode.
• Provide screenshot functionality for pages and elements.
• Log browser console messages and execute JavaScript.
• Offer comprehensive interaction methods (click, fill, select, hover).

📦 Components

Tools

• puppeteer_navigate

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

• puppeteer_screenshot

  • Capture a screenshot of a page or a specific element.
  • Parameters:
    • name (string, required): The name of the screenshot.
    • selector (string, optional): The CSS selector (for element screenshots).
    • width (number, optional, default: 800): The width of the screenshot.
    • height (number, optional, default: 600): The height of the screenshot.

• puppeteer_click

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

• puppeteer_hover

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

• puppeteer_fill

  • Fill in the content of an input field.
  • Parameters:
    • selector (string): The selector of the input box.
    • value (string): The content to fill.

• puppeteer_select

  • Select an element with the SELECT tag.
  • Parameters:
    • selector (string): The selector of the element to select.
    • value (string): The value to select.

• puppeteer_evaluate

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

Resources

The server provides two types of resource access:

1. Console Logs (console://logs)

• Text information output from the browser console.
• Includes all console messages from the browser.

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

• PNG-format screenshot images of pages or elements.
• Accessed by the name specified during screenshot capture.

🔧 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 a 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", "MCP_puppeteer_extra"]
    }
  }
}

📄 License

This MCP server is licensed under the MIT License.