browser-mcp-server

A universal browser automation MCP server using Playwright. Control Chrome programmatically through the Model Context Protocol.

63 powerful browser automation tools including multi-tab management, media monitoring/control, low-level interaction, session recording, CDP-based performance profiling, network analysis, security testing, and on-demand documentation.

• ✅ Smart Chrome Detection: Automatically finds and uses system Chrome/Chromium
• ✅ Three-Tier Strategy: Antigravity Chrome → System Chrome → Playwright Chromium
• ✅ Universal: Works with Antigravity, Claude Desktop, and any MCP client
• ✅ 63 Tools: Media control, multi-tab, pixel-based interaction, CDP power user tools, and more
• ✅ On-Demand Docs: Built-in documentation tool with return schemas and examples
• ✅ Auto-Install: Playwright installed automatically via npm (no manual setup)
• ✅ Safe: Isolated browser profile (won't touch your personal Chrome)
• ✅ Console Capture: Debug JavaScript errors in real-time
• ✅ Session Recording: Playwright traces with screenshots, DOM, and network activity
• ✅ Auto-Reconnect: Handles browser crashes gracefully

| Installation Method | Best For | Setup Time | |-------------------|----------|------------| | NPM Package | Production use, easy updates | 30 seconds | | Clone Repository | Development, contributing | 2 minutes | | Direct Download | Quick testing, minimal setup | 1 minute |

| MCP Client | Config File Location | |------------|---------------------| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)<br>%APPDATA%/Claude/claude_desktop_config.json (Windows) | | Antigravity | ~/.gemini/antigravity/mcp_config.json | | Claude Code | Use claude mcp add command | | Gemini CLI | Use gemini mcp add command |

Key Points:

• ✅ Requires Node.js >= 16.0.0
• ✅ Playwright installs automatically (vi