puppeteer-mcp-server

Overview

The puppeteer-mcp-server provides a comprehensive suite of 16 browser automation tools via the Model Context Protocol. It includes core browser navigation tools, advanced mouse interaction capabilities, and cookie management for authentication handling. The server supports both modern streamable HTTP transport and legacy SSE transport, with API key authentication for security. It's production-ready with Docker support, rate limiting, health monitoring, and comprehensive logging.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• puppeteer_navigate

  Navigate to URLs with safety validation

  Try:Navigate to https://example.comTry:Go to the Google homepage
• puppeteer_screenshot

  Take full page or element screenshots

  Try:Take a screenshot of the current pageTry:Capture a screenshot of the login button
• puppeteer_click

  Click elements with retry logic

  Try:Click the submit buttonTry:Click the download link with id 'download-btn'
• puppeteer_fill

  Fill input fields with validation

  Try:Fill in the username field with 'john_doe'Try:Enter 'password123' in the password input
• puppeteer_select

  Select options from dropdown elements

  Try:Select 'United States' from the country dropdownTry:Choose the 'Premium' option from the plan selector
• puppeteer_hover

  Hover over elements with effect detection

  Try:Hover over the menu itemTry:Move the mouse over the interactive element
• puppeteer_evaluate

  Execute JavaScript with console capture

  Try:Run document.querySelector('h1').textContentTry:Get all links on the page
• puppeteer_mouse_move

  Precise coordinate movement with smooth interpolation

  Try:Move the mouse to coordinates x:300, y:200Try:Smoothly move to position 500, 400 in 10 steps
• puppeteer_mouse_click

  Advanced clicking with button options (left/right/middle/back/forward)

  Try:Right-click at coordinates 400, 300Try:Double-click the submit button
• puppeteer_mouse_down

  Mouse button press for drag operations

  Try:Press the left mouse button at position 200, 150Try:Hold down the right mouse button
• puppeteer_mouse_up

  Mouse button release for drag operations

  Try:Release the left mouse button at position 250, 200Try:Let go of the right mouse button
• puppeteer_mouse_wheel

  Mouse wheel scrolling with deltaX/deltaY control

  Try:Scroll down by 120 pixelsTry:Scroll horizontally with deltaX: -50, deltaY: 0

Comparable tools

Installation

# Clone the repository
git clone https://github.com/sultannaufal/puppeteer-mcp-server.git
cd puppeteer-mcp-server

# Create .env file with your API key
echo "API_KEY=your-secure-api-key-here" > .env

# Start with Docker Compose
docker compose --env-file .env up -d

# Prerequisites: Node.js 18+, npm 8+
npm install
npm run build
npm start

{
  "mcpServers": {
    "puppeteer": {
      "command": "node",
      "args": ["dist/server.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

FAQ

How do I authenticate with the server?

All endpoints require Bearer token authentication. Set your API_KEY environment variable and include 'Authorization: Bearer your-api-key' in your requests.

What transport protocols are supported?

The server supports both modern streamable HTTP transport (MCP 2025-06-18 specification) and legacy SSE transport for backward compatibility.

Compare puppeteer-mcp-server with