Overview
MCP-DevTools is a Model Context Protocol (MCP) server implementation designed to enhance browser automation and DevTools capabilities using Puppeteer.
To use MCP-DevTools, you need to set up a Docker environment and configure it in the Cursor IDE. Follow the setup instructions to build the Docker image and run the server.
- Full browser automation support via Puppeteer - Enhanced DevTools Protocol integration - Docker support for consistent environments - Non-root user execution for security - Cross-platform compatibility
- Automating web testing and scraping tasks.
- Enhancing browser automation workflows in development.
- Running headless browser sessions in a secure environment.
Add to your AI client
Use these steps to connect MCP-DevTools in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-pptr-ringotc": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-pptr-ringotc"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-pptr-ringotc": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-pptr-ringotc"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-pptr-ringotc": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-pptr-ringotc"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-pptr-ringotc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-pptr-ringotc"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-pptr-ringotc": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-pptr-ringotc"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-pptr-ringotc": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-pptr-ringotc"
]
}
}
}FAQ
What are the prerequisites for using MCP-DevTools?
You need Docker and Cursor IDE to use MCP-DevTools.
How do I configure MCP-DevTools?
You can configure it by adding the necessary command in the Cursor Settings under MCP Configuration.
Is MCP-DevTools secure?
Yes, it runs as a non-root user in Docker and uses Chromium's sandbox for security.