3D MCP Cursor Visualization
Puppeteer MCP Logo - AI-Powered Development Tool for Cursor IDE

Puppeteer MCP

Model Context Protocol Integration

Overview

A Model Context Protocol server that provides browser automation capabilities using Puppeteer. This server enables LLMs to interact with web pages, take screenshots, execute JavaScript, and perform various browser-based operations in a real browser environment.

View Repository

Puppeteer Features

  • •Browser automation
  • •Screenshot capture
  • •JavaScript execution
  • •Form interaction
  • •Element selection and clicking
  • •Console log monitoring
  • •Navigation control

Puppeteer Setup & Configuration

Requirements

  • •Node.js
  • •Docker (for headless mode)
  • •Claude Desktop

Installation Instructions

# Docker Installation (Headless)
docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .
docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

# NPX Installation (With Browser Window)
npx -y @modelcontextprotocol/server-puppeteer

Configuration

# Docker Configuration (Headless)
{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer"]
    }
  }
}

# NPX Configuration (With Browser Window)
{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

Puppeteer Available Tools

  • •puppeteer_navigate
  • •puppeteer_screenshot
  • •puppeteer_click
  • •puppeteer_hover
  • •puppeteer_fill
  • •puppeteer_select
  • •puppeteer_evaluate

Puppeteer Required Inputs

url

Type
string
Description
URL to navigate to
Required
Yes

selector

Type
string
Description
CSS selector for element interaction
Required
No

script

Type
string
Description
JavaScript code to execute
Required
No

value

Type
string
Description
Value for form inputs
Required
No

name

Type
string
Description
Name for screenshots
Required
No

width

Type
number
Description
Screenshot width
Required
No

height

Type
number
Description
Screenshot height
Required
No

Puppeteer Use Cases

  • •Web automation testing
  • •Screenshot generation
  • •Form automation
  • •Web scraping
  • •JavaScript execution
  • •Browser interaction
  • •Console monitoring

Frequently Asked Questions

A Model Context Protocol server that provides browser automation capabilities using Puppeteer. This server enables LLMs to interact with web pages, take screenshots, execute JavaScript, and perform various browser-based operations in a real browser environment.
Node.js, Docker (for headless mode), Claude DesktopView detailed requirements
Follow the installation instructions in the setup section above.View installation guide

Puppeteer MCP provides the following tools:

  • •puppeteer_navigate
  • •puppeteer_screenshot
  • •puppeteer_click
  • •puppeteer_hover
  • •puppeteer_fill
  • •puppeteer_select
  • •puppeteer_evaluate

Featured MCPs