MCP-DevTools
by RingoTC
MCP-DevTools is a Model Context Protocol (MCP) server implementation designed to enhance browser automation and DevTools capabilities using Puppeteer. It provides a robust environment for browser automation with enhanced security features.
View on GitHub
Last updated: N/A
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
- Build the Docker image:
docker build -t mcp/puppeteer .
- 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 executableDISPLAY
: X11 display for headless modeCHROME_BIN
: Chrome binary path
Security
- Runs as non-root user in Docker
- Uses Chromium's sandbox
- Implements proper permission handling
License
MIT License
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a new Pull Request