MCP Catalogs
Homereal-browser-mcp screenshot

real-browser-mcp

by ofershap·20·Score 43

MCP server + Chrome extension enabling AI agents to control real browser sessions with existing logins and cookies.

browser-automationdeveloper-toolsweb-scraping
3
Forks
2
Open issues
this month
Last commit
2d ago
Indexed

Overview

Real Browser MCP is a powerful MCP server that bridges the gap between AI coding assistants and real browser environments. It consists of two main components: an MCP server that runs locally and communicates with AI clients, and a Chrome extension that executes commands in the browser. The solution allows AI agents to interact with existing browser sessions, preserving cookies, login states, and authentication. This eliminates the need for repeated login flows and enables AI agents to verify their work directly in the user's browser.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

you:AI agents testing and verifying their code changes in real browser environments
you:Web automation with existing authenticated sessions
you:AI-driven QA testing of web applications without re-authentication
you:Cross-browser testing of web applications by AI agents
you:Does it work with my logged-in sessions?
you:Does it send data anywhere?

When to choose this

Choose this when your AI agent needs to interact with your authenticated browser sessions without re-authentication or when you need to maintain state between AI actions.

When NOT to choose this

Don't choose this for headless browser automation scenarios where you don't need a visual browser or if you're looking for a cross-browser solution beyond Chrome.

Tools this server exposes

12 tools extracted from the README
  • browser_snapshot

    Accessibility tree with element refs. Compact mode returns only interactive elements

  • browser_screenshot

    Capture what's on screen

  • browser_text

    Extract raw text from page or element

  • browser_find

    Query elements by CSS selector

  • browser_click

    Click by ref or CSS selector

  • browser_click_text

    Click by visible text. Works through React portals and overlays

  • browser_type

    Type into inputs and contenteditable fields

  • browser_press_key

    Key combos (Enter, Escape, Ctrl+A)

  • browser_scroll

    Scroll pages and virtual containers

  • browser_navigate

    Go to a URL in the active tab

  • browser_tabs

    List, create, close, or focus tabs

  • browser_console

    Console output (log, warn, error)

Comparable tools

playwright-mcpbrowser-usechrome-devtools-mcp

Installation

Installation

1. Add the MCP server

**Cursor (one click):** [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" height="32" />](cursor://anysphere.cursor-deeplink/mcp/install?name=real-browser&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInJlYWwtYnJvd3Nlci1tY3AiXX0=)

Or add manually in Cursor Settings > MCP > "Add new MCP server":

{
  "mcpServers": {
    "real-browser": {
      "command": "npx",
      "args": ["-y", "real-browser-mcp"]
    }
  }
}

**Claude Desktop, Windsurf, or other MCP clients:** Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Add the same JSON block.

2. Install the Chrome extension

[<img src="https://developer.chrome.com/static/docs/webstore/branding/image/iNEddTyWiMfLSwFD6qGq.png" alt="Available in the Chrome Web Store" height="58" />](https://chromewebstore.google.com/detail/real-browser-mcp/fkkimpklpgedomcheiojngaaaicmaidi)

Or load from source:

git clone https://github.com/ofershap/real-browser-mcp.git
cd real-browser-mcp
open chrome://extensions
# Enable Developer mode (toggle in top right)
# Click Load unpacked and select the extension/ folder

3. Teach Your Agent

Run one command:

npx real-browser-mcp --setup cursor

This installs agent rules and browser checking commands.

FAQ

Does it work with my logged-in sessions?
Yes, that's the whole point. The extension runs inside your actual Chrome with the same cookies, sessions, and local storage. No re-authentication needed.
Does it send data anywhere?
No. The MCP server and extension communicate over WebSocket on localhost. Nothing leaves your machine. There's no analytics, telemetry, or cloud component.

Compare real-browser-mcp with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.