Pptr

A Model Context Protocol (MCP) server implementation for enhanced browser automation and DevTools capabilities using Puppeteer.

Features

• Full browser automation support via Puppeteer
• Enhanced DevTools Protocol integration
• Docker support for consistent environments
• Non-root user execution for security
• Cross-platform compatibility

Prerequisites

• Docker
• Cursor IDE

Setup

1. Build the Docker image:

docker build -t mcp/puppeteer .

2. Configure in Cursor:
   • Open Cursor Settings
   • Navigate to MCP Configuration
   • Add the following command:

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

Configuration

The server is configured to run on port 3000 by default. Environment variables:

• PUPPETEER_EXECUTABLE_PATH: Path to Chromium executable
• DISPLAY: X11 display for headless mode
• CHROME_BIN: Chrome binary path

Security

• Runs as non-root user in Docker
• Uses Chromium's sandbox
• Implements proper permission handling

License

MIT License

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request