src_puppeteer
by modelcontextprotocolPuppeteer Browser Automation MCP Server
Overview
The Puppeteer Browser Automation MCP Server is a powerful tool that enables browser automation capabilities using Puppeteer. It allows Large Language Models (LLMs) to interact with web pages, take screenshots, and execute JavaScript in a real browser environment. This server is part of the Model Context Protocol (MCP) and provides a seamless way to automate web interactions.
Key Features
- Browser Automation: Navigate, click, and interact with web pages.
- Console Log Monitoring: Capture and monitor browser console output.
- Screenshot Capabilities: Capture screenshots of entire pages or specific elements.
- JavaScript Execution: Execute custom JavaScript code in the browser console.
- Basic Web Interaction: Perform actions like navigation, clicking, and form filling.
Components
Tools
- puppeteer_navigate: Navigate to any URL in the browser.
- Input:
url(string) - puppeteer_screenshot: Capture screenshots of the entire page or specific elements.
- Inputs:
name(string, required): Name for the screenshot.selector(string, optional): CSS selector for element to screenshot.width(number, optional, default: 800): Screenshot width.height(number, optional, default: 600): Screenshot height.
- puppeteer_click: Click elements on the page.
- Input:
selector(string): CSS selector for element to click. - puppeteer_hover: Hover elements on the page.
- Input:
selector(string): CSS selector for element to hover. - puppeteer_fill: Fill out input fields.
- Inputs:
selector(string): CSS selector for input field.value(string): Value to fill.
- puppeteer_select: Select an element with SELECT tag.
- Inputs:
selector(string): CSS selector for element to select.value(string): Value to select.
- puppeteer_evaluate: Execute JavaScript in the browser console.
- Input:
script(string): JavaScript code to execute.
Resources
- Console Logs (
console://logs): Browser console output in text format. - Screenshots (
screenshot://<name>): PNG images of captured screenshots.
Configuration to Use Puppeteer Server
Docker
NOTE: The Docker implementation will use headless Chromium, whereas the NPX version will open a browser window.
{
"mcpServers": {
"puppeteer": {
"command": "docker",
"args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer"]
}
}
}
NPX
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
}
}
}
Build
To build the Docker image:
docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .
License
This MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Invite Gmail Contacts
