MCP Puppeteer Server

🚀 Puppeteer Server

A Model Context Protocol (MCP) server implemented using Puppeteer, offering browser automation capabilities. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript code, simulating a real browser environment.

🚀 Quick Start

This Puppeteer Server provides browser automation functions, allowing LLMs to interact with web pages, capture screenshots, and execute JavaScript code. Below is a detailed introduction to its components, features, and usage.

✨ Features

• Browser automation operations
• Console log monitoring
• Screenshot function
• JavaScript code execution
• Basic web page interactions (navigation, clicking, form filling)

📦 Installation

Docker

Note: The Docker version will use headless Chromium, while 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"]
    }
  }
}

💻 Usage Examples

Components

Tools

• puppeteer_navigate

  • Function: Navigate to any URL
  • Input Parameters: url (string)

• puppeteer_screenshot

  • Function: Take a screenshot of a web page or a specific element
  • Input Parameters:
    • name (string, required): Screenshot name
    • selector (string, optional): CSS selector for filtering elements
    • width (number, optional, default: 800): Screenshot width
    • height (number, optional, default: 600): Screenshot height

• puppeteer_click

  • Function: Click an element on the page
  • Input Parameters: selector (string): Selector of the element to click

• puppeteer_hover

  • Function: Hover over an element on the page
  • Input Parameters: selector (string): Selector of the element to hover over

• puppeteer_fill

  • Function: Fill in form fields
  • Input Parameters:
    • selector (string): Form field selector
    • value (string): Content to fill in

• puppeteer_select

  • Function: Select an element from a dropdown list
  • Input Parameters:
    • selector (string): Selector of the dropdown list
    • value (string): Value to select

• puppeteer_evaluate

  • Function: Execute JavaScript code in the browser console
  • Input Parameters: script (string): JavaScript code to execute

Resources

This server provides two types of resources:

1. Console Logs (console://logs)

• Text information output from the browser console
• Contains all console messages from the browser

2. Screenshots (screenshot://<name>)

• Page screenshots in PNG format
• Access screenshots by the name specified during capture

🔧 Technical Details

Building with Docker

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

📄 License

This MCP server is licensed under the MIT License. This means you can freely use, modify, and distribute the software for any purpose, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.