MCP serverSafeBrowser automation & web dataSome setup

stealth-browser-mcp

vibheksoni · vibheksoni/stealth-browser-mcp

Provides stealth browser automation for AI agents via MCP, enabling navigation, DOM extraction, and anti-bot bypass.

Stealth browser automation for AI agents over MCP and the Chrome DevTools Protocol: navigation, network hooks, DOM extraction, and pixel-accurate UI cloning.

2.2k stars302License: MITUpdated 13 days ago0 opens

See it in action

From the author's READMERendered screenshot of a complex website captured by the stealth browser

From the author's README vibheksoni ·Source

What you can do with it

Enable an AI agent to scrape data from websites protected by Cloudflare or anti-bot measures.
Automate complex browser workflows for an agent, including login and form submissions.
Have an AI agent perform pixel-accurate UI cloning or visual testing on web pages.

Safety check

Safe

No risky patterns found in the files we scanned.

Automated scan of the repo files. Always review code you run.

From the README

Stealth Browser MCP

Stealth browser automation for MCP-compatible AI agents.

Navigate Cloudflare challenges, anti-bot checks, and login walls with real Chrome-family browser instances powered by nodriver, Chrome DevTools Protocol, and FastMCP.

Demo

Stealth Browser MCP passing a Cloudflare challenge, cloning UI elements, and inspecting network traffic through AI chat commands.

Features

Anti-bot resistance - Has passed Cloudflare and Queue-It style challenges in testing; results vary by site, region, browser version, and detector version.
98 tools across 11 sections - From basic navigation to advanced CDP function execution.
Modular loading - Run the full 98-tool surface or a minimal 21-tool core; disable sections you do not need.
Pixel-accurate element cloning - Extract complete elements with CSS, DOM structure, events, animations, and assets via CDP.
Network inspection - Inspect requests, responses, headers, payloads, and captured bodies through your AI agent.
Dynamic hook system - Restricted Python hooks can intercept, block, redirect, fulfill, or modify request/response flows.
CDP execution - Run JavaScript, direct CDP commands, and pre-document scripts through trusted local MCP clients.
Instant text input - Paste large content via CDP, type with human-like keystrokes, or press real keys with trusted CDP key events.
Cross-platform - Windows, macOS, Linux, Docker, and CI environments with automatic browser/platform detection.
Browser support - Chrome, Chromium, and Microsoft Edge with automatic executable discovery.
Clean MCP integration - Works through standard MCP clients without custom brokers.

Quickstart

1. Clone and install

Requires Python 3.10+ and Chrome, Chromium, or Microsoft Edge.

git clone https://github.com/vibheksoni/stealth-browser-mcp.git
cd stealth-browser-mcp
python -m venv venv

# Windows
venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

pip install -r requirements.txt

2. Add to your MCP client

Claude Code CLI (recommended):

Windows:

claude mcp add-json stealth-browser-mcp "{\"type\":\"stdio\",\"command\":\"C:\\path\\to\\stealth-browser-mcp\\venv\\Scripts\\python.exe\",\"args\":[\"C:\\path\\to\\stealth-browser-mcp\\src\\server.py\"]}"

macOS / Linux:

claude mcp add-json stealth-browser-mcp '{
  "type": "stdio",
  "command": "/path/to/stealth-browser-mcp/venv/bin/python",
  "args": ["/path/to/stealth-browser-mcp/src/server.py"]
}'

Replace the example path with your real clone path.

Manual JSON configuration (Claude Desktop, Cursor, etc.)

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "stealth-browser-mcp": {
      "command": "C:\\path\\to\\stealth-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\stealth-browser-mcp\\src\\server.py"],
      "env": {}
    }
  }
}

macOS / Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "stealth-browser-mcp": {
      "command": "/path/to/stealth-browser-mcp/venv/bin/python",
      "args": ["/path/to/stealth-browser-mcp/src/server.py"],
      "env": {}
    }
  }
}

Experimental FastMCP CLI install

These commands are provided for users who prefer FastMCP's installer. The stdio JSON setup above is the recommended path.

pip install fastmcp
fastmcp install claude-desktop src/server.py --with-requirements requirements.txt
fastmcp install claude-code src/server.py --with-requirements requirements.txt
fastmcp install cursor src/server.py --with-requirements requirements.txt

3. Test it

Restart your MCP client and ask your agent:

Use stealth-browser to navigate to https://example.com and take a screenshot.

Agent Skill

This repo includes an agent skill at skills/stealth-browser-mcp for clients that support Codex-style

View source on GitHub