MCP-DevTools logo

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

What is MCP-DevTools?

MCP-DevTools is a server implementation of the Model Context Protocol (MCP) that leverages Puppeteer to provide enhanced browser automation and DevTools capabilities. It allows users to automate browser tasks, integrate with DevTools protocols, and maintain consistent environments using Docker.

How to use MCP-DevTools?

To use MCP-DevTools, first build the Docker image using docker build -t mcp/puppeteer .. Then, configure it within Cursor IDE by navigating to MCP Configuration and adding the command docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer. The server runs on port 3000 by default.

Key features of MCP-DevTools

  • Full browser automation support via Puppeteer

  • Enhanced DevTools Protocol integration

  • Docker support for consistent environments

  • Non-root user execution for security

Use cases of MCP-DevTools

  • Automated testing

  • Web scraping

  • UI automation

  • Generating website screenshots

FAQ from MCP-DevTools

What is the default port?

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

What environment variables can be configured?

You can configure PUPPETEER_EXECUTABLE_PATH, DISPLAY, and CHROME_BIN environment variables.

How is security handled?

The server runs as a non-root user in Docker, uses Chromium's sandbox, and implements proper permission handling.

What are the prerequisites?

Docker and Cursor IDE are required.

How can I contribute?

Fork the repository, create your feature branch, commit your changes, push to the branch, and create a new Pull Request.