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-puppeteerConfiguration
# 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
