merajmehrabi_puppeteer-mcp-server

The Puppeteer MCP Server is a robust tool designed for browser automation using Puppeteer. It allows users to interact with web pages by navigating, taking screenshots, clicking elements, filling forms, and more. The server supports smart Chrome tab management, enabling connections to active Chrome tabs and preserving existing Chrome instances. It offers detailed logging and error handling, ensuring users can track operations and troubleshoot effectively. The server is structured with a clear project layout, including configuration modules, tool definitions, and browser connection management. It supports both standard mode, launching a new browser instance, and active tab mode, connecting to existing Chrome windows with remote debugging enabled.

Features

• Navigate web pages
• Take screenshots
• Click elements
• Fill forms
• Smart Chrome tab management

MCP Tools

• puppeteer_connect_active_tab: Connect to an existing Chrome instance with remote debugging enabled.
• puppeteer_navigate: Navigate to a URL.
• puppeteer_screenshot: Take a screenshot of the current page or a specific element.
• puppeteer_click: Click an element on the page.
• puppeteer_fill: Fill out an input field.
• puppeteer_select: Use dropdown menus.
• puppeteer_hover: Hover over elements.
• puppeteer_evaluate: Execute JavaScript in the browser console.

Usage with Different Platforms

Windows

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Linux

google-chrome --remote-debugging-port=9222