Puppeteer MCP Server logo

Puppeteer MCP Server

by MCP-Mirror

This MCP server provides browser automation capabilities through Puppeteer, allowing interaction with both new browser instances and existing Chrome windows. It offers a range of tools for web page interaction and data extraction.

View on GitHub

Last updated: N/A

What is Puppeteer MCP Server?

The Puppeteer MCP Server is a server that exposes Puppeteer's browser automation capabilities through an interface, enabling users to control and interact with web browsers programmatically. It supports both launching new browser instances and connecting to existing Chrome windows.

How to use Puppeteer MCP Server?

The server can be used in standard mode, launching a new browser instance, or in active tab mode, connecting to an existing Chrome window with remote debugging enabled. To use active tab mode, launch Chrome with the --remote-debugging-port flag, navigate to the desired webpage, and then use the puppeteer_connect_active_tab tool to connect. Other tools like puppeteer_navigate, puppeteer_screenshot, puppeteer_click, etc., can then be used to interact with the browser.

Key features of Puppeteer MCP Server

  • Navigate web pages

  • Take screenshots

  • Click elements

  • Fill forms

  • Select options

  • Hover elements

  • Execute JavaScript

  • Smart Chrome tab management (connect to active tabs, preserve instances)

Use cases of Puppeteer MCP Server

  • Automated web testing

  • Web scraping and data extraction

  • Generating screenshots of websites

  • Automating form filling and submission

  • Web UI automation

FAQ from Puppeteer MCP Server

What is the default debugging port?

The default debugging port is 9222.

How do I connect to an existing Chrome instance?

Launch Chrome with remote debugging enabled using the --remote-debugging-port flag and then use the puppeteer_connect_active_tab tool.

Where are the logs stored?

Logs are stored in the logs/ directory.

What is the log rotation policy?

Logs are rotated daily, with a maximum size of 20MB per file and a retention period of 14 days. Old logs are automatically compressed.

What license is this project under?

This project is licensed under the MIT License.