MCP-DevTools

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