Configurable Puppeteer MCP Server
@afshawnlotfi
Configurable Puppeteer MCP Server
Overview
What is Configurable Puppeteer MCP Server?
Configurable Puppeteer MCP Server is a Model Context Protocol server that provides browser automation capabilities using Puppeteer with configurable launch options. It enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment, with customization through environment variables.
How to use Configurable Puppeteer MCP Server?
Use the NPX command npx -y github:afshawnlotfi/mcp-configurable-puppeteer in your MCP client configuration. Optionally set the PUPPETEER_ARGS environment variable to a JSON string of custom Puppeteer launch options (e.g., to use Firefox or set viewport size).
Key features of Configurable Puppeteer MCP Server
- Browser automation for web page interaction
- Console log monitoring from the browser
- Screenshot capturing of entire pages or elements
- JavaScript execution in the browser console
- Basic web interaction: navigation, clicking, form filling
- Configurable Puppeteer options through environment variables
Use cases of Configurable Puppeteer MCP Server
- Navigate to any URL and capture screenshots
- Automate form filling and clicking on web pages
- Execute JavaScript to extract dynamic content
- Monitor browser console logs for debugging or data collection
- Interact with web elements via hover, select, and evaluate commands
FAQ from Configurable Puppeteer MCP Server
How do I configure custom Puppeteer options?
Set the PUPPETEER_ARGS environment variable to a JSON string of Puppeteer launch options, such as {"browser": "firefox"} or {"defaultViewport": {"width": 1280, "height": 800}}.
What tools are available in this server?
Tools include puppeteer_navigate, puppeteer_screenshot, puppeteer_click, puppeteer_hover, puppeteer_fill, puppeteer_select, and puppeteer_evaluate.
How do I access screenshots after capturing them?
Screenshots are accessible via the resource screenshot://<name>, where <name> is the name provided during capture.
What resources does the server provide?
The server provides console logs at console://logs (text format) and screenshots at screenshot://<name> (PNG images).
How do I execute JavaScript in the browser?
Use the puppeteer_evaluate tool with the script input containing the JavaScript code to execute.
