ofershap/real-browser-mcp

MCP server + Chrome extension that gives AI agents control of your real browser with existing sessions and logins

48 ★5 forksJavaScriptUpdated 18d ago

What you need to know

MCP server plus Chrome extension (Manifest V3) that bridges coding agents to the Chrome you already have open over a localhost WebSocket - cookies, SSO, staging sessions, and already-reproduced bugs included. 18 tools grouped into See (snapshot, screenshot, text, find), Interact (click, click_text, type, press_key, scroll, hover, select, wait), Navigate (navigate, tabs), and Debug (console, network, evaluate via CDP, handle_dialog). Not for CI/parallel clean runs (use Playwright there); unlike CDP, it avoids Chrome 136+'s block on remote debugging of the default profile by using an extension bridge. Everything stays on your machine. npx real-browser-mcp; TypeScript, MIT.

Install

npx -y real-browser-mcp
Chrome extension from the Chrome Web Store (real-browser-mcp)
npx real-browser-mcp --setup cursor (or --setup claude) to install agent rules

Key features

✓Drive your existing logged-in Chrome (cookies, SSO, sessions)
✓18 tools: snapshot, screenshot, click, type, press_key, scroll, hover, select, wait, tabs, console, network, evaluate, handle_dialog
✓Extension bridge over localhost WebSocket instead of CDP debug port
✓Agent Plugins 1.0.0 package with skill and rules
✓Connection handling with backoff and ping/pong health checks

Best for

Live verification of fixes against real sessions in the IDE coding loop

Caveats

⚠Not for CI or parallel clean runs - use Playwright there
⚠Chrome extension is required
⚠Agent can read/click anything visible in the connected tab, including logged-in apps

Clients: Cursor · Claude Desktop · Claude Code · Windsurf · Cline · Any MCP client

Reviewed 2026-08-11

Topics

aibrowser-automation chrome-extensionclaudecursormcpmcp-servermodel-context-protocoltypescript

Stars: 48★
Forks: 5
Language: JavaScript
License: MIT
Created: 2026-03-02
Last push: 2026-08-17