PPTR

Puppeteer-powered MCP server for browser automation and DevTools integration with Docker-based, non-root execution.

other

GitHub Stars

other

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ringotc-mcp-pptr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "mcp/puppeteer"
      ],
      "env": {
        "DISPLAY": ":0",
        "CHROME_BIN": "/usr/bin/google-chrome",
        "DOCKER_CONTAINER": "true",
        "PUPPETEER_EXECUTABLE_PATH": "PATH_TO_CHROMIUM"
      }
    }
  }
}

You set up an MCP server that uses Puppeteer to automate browser tasks and integrate with DevTools, all inside a Docker container. This server lets you drive browser interactions through the MCP protocol in a secure, non-root environment across platforms.

How to use

You run the server in a local or remote MCP-enabled client environment and connect to it to perform browser automation and DevTools actions. By default, the server runs inside Docker and exposes its capabilities through the MCP protocol. You configure environment variables to point to the Chromium/Chrome binaries and X11 display as needed, then start the container and connect your MCP client to begin automation tasks.

How to install

Prerequisites you need before starting:

Install Docker on your system. The server runs inside a Docker container for consistency and security.

Optional: Install Cursor IDE if you want a guided configuration flow inside Cursor.

Build the Docker image that contains the MCP Puppeteer server.

docker build -t mcp/puppeteer .

Configure the MCP server in Cursor by launching the container with the required environment flag.

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

Available tools

puppeteerAutomation

Automates browser actions using Puppeteer within the MCP framework, enabling scripted navigation, form interaction, and screenshots.

devtoolsIntegration

Leverages DevTools Protocol capabilities to inspect and control browser state, pages, and performance measures.

dockerEnvironment

Provides a consistent, isolated runtime using Docker, ensuring non-root execution and secure container boundaries.

crossPlatformSupport

Offers compatibility across platforms by running inside Docker and exposing MCP interfaces in a portable way.

Built by

VeilStrat

AI signals for GTM teams