Version 4.43 or later needs to be installed to add the server automatically
About
Browser automation and web scraping using Puppeteer.
Attribute | Details |
---|---|
Docker Image | mcp/puppeteer |
Author | modelcontextprotocol |
Repository | https://github.com/modelcontextprotocol/servers |
Dockerfile | https://github.com/modelcontextprotocol/servers/blob/2025.4.24/src/puppeteer/Dockerfile |
Docker Image built by | Docker Inc. |
Docker Scout Health Score | |
Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/puppeteer --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
Licence | MIT License |
Tools provided by this Server | Short Description |
---|---|
puppeteer_click | Click an element on the page |
puppeteer_evaluate | Execute JavaScript in the browser console |
puppeteer_fill | Fill out an input field |
puppeteer_hover | Hover an element on the page |
puppeteer_navigate | Navigate to a URL |
puppeteer_screenshot | Take a screenshot of the current page or a specific element |
puppeteer_select | Select an element on the page with Select tag |
puppeteer_click
Click an element on the page
Parameters | Type | Description |
---|---|---|
selector | string | CSS selector for element to click |
puppeteer_evaluate
Execute JavaScript in the browser console
Parameters | Type | Description |
---|---|---|
script | string | JavaScript code to execute |
puppeteer_fill
Fill out an input field
Parameters | Type | Description |
---|---|---|
selector | string | CSS selector for input field |
value | string | Value to fill |
puppeteer_hover
Hover an element on the page
Parameters | Type | Description |
---|---|---|
selector | string | CSS selector for element to hover |
puppeteer_navigate
Navigate to a URL
Parameters | Type | Description |
---|---|---|
url | string | URL to navigate to |
allowDangerous | boolean optional | Allow dangerous LaunchOptions that reduce security. When false, dangerous args like --no-sandbox will throw errors. Default false. |
launchOptions | object optional | PuppeteerJS LaunchOptions. Default null. If changed and not null, browser restarts. Example: { headless: true, args: ['--no-sandbox'] } |
puppeteer_screenshot
Take a screenshot of the current page or a specific element
Parameters | Type | Description |
---|---|---|
name | string | Name for the screenshot |
height | number optional | Height in pixels (default: 600) |
selector | string optional | CSS selector for element to screenshot |
width | number optional | Width in pixels (default: 800) |
puppeteer_select
Select an element on the page with Select tag
Parameters | Type | Description |
---|---|---|
selector | string | CSS selector for element to select |
value | string | Value to select |
{
"mcpServers": {
"puppeteer": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DOCKER_CONTAINER",
"mcp/puppeteer"
],
"env": {
"DOCKER_CONTAINER": "true"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for