# stealth-browser-mcp [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/vibheksoni/stealth-browser-mcp  
**GitHub Stars:** 3382  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/stealth-browser-mcp

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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "stealth-browser-mcp": {
    "command": "uvx",
    "args": ["browserstealthmcp"]
  }
}
```

## Documentation

## What stealth-browser-mcp does

stealth-browser-mcp gives MCP-compatible agents control of real Chrome-family browser instances. Its capabilities cover ordinary browser automation as well as lower-level Chrome DevTools Protocol operations, allowing an agent to navigate pages, inspect rendered content, observe network traffic, and interact with browser state.

The server is designed for sites where conventional browser automation may encounter Cloudflare challenges, Queue-It-style checks, anti-bot detection, or login walls. Testing has passed some Cloudflare and Queue-It-style challenges, but outcomes vary with the site, region, browser version, and detector version.

A distinctive capability is element cloning. Agents can extract an element together with its CSS, DOM structure, events, animations, and assets, supporting pixel-accurate recreation of interface components.

## How it works

The implementation uses nodriver to control Chrome-family browsers through the Chrome DevTools Protocol. FastMCP provides the MCP server layer, so clients communicate through the normal MCP interface rather than a custom broker.

The full toolbox contains 101 tools organized into 11 sections. A smaller 21-tool core can be used instead, and sections can be disabled to reduce the exposed surface. The server can also load restricted Python hooks that intercept, block, redirect, fulfill, or modify request and response flows.

CDP-based operations include running page JavaScript, issuing direct CDP commands, installing scripts before a document loads, and entering text through pasted CDP content, human-like typing, or trusted CDP key events. Network inspection can expose requests, responses, headers, payloads, and captured response bodies.

## Setup and configuration

Python 3.10 or newer and Chrome, Chromium, or Microsoft Edge are required. The recommended installation uses pipx:

```bash
pipx install browserstealthmcp
```

This installs the `stealth-browser-mcp` command. `uvx browserstealthmcp` can run it without a permanent installation. The package name on PyPI is `browserstealthmcp`; installing `stealth-browser-mcp` refers to an unrelated project.

For development, clone the repository, create a virtual environment, activate it, and install `requirements.txt`. Add the server to an MCP client with the command `stealth-browser-mcp`, or point the client at the Python interpreter and `src/server.py` from a local clone. The server uses stdio configuration with no required environment variables.

A repository skill is available at `skills/stealth-browser-mcp` for clients that support Codex-style skills. It teaches recommended tool ordering, browser-state checks, pre-document CDP usage, network-debugging flow, and cleanup practices.

## Tools and capabilities

- Navigate pages and control browser interactions.
- Capture screenshots and inspect rendered DOM content.
- Extract complete elements for UI cloning, including styles, structure, events, animations, and assets.
- Inspect network requests, responses, headers, payloads, and captured bodies.
- Intercept, block, redirect, fulfill, or modify traffic with restricted Python hooks.
- Execute page JavaScript, direct CDP commands, and pre-document scripts.
- Enter large text through CDP or simulate human-like typing and real key events.
- Choose the full 101-tool surface or a modular 21-tool core.

## Limitations and notes

Browser automation results against anti-bot systems are not guaranteed and can change with site behavior, geography, browser versions, and detector updates. CDP execution, JavaScript execution, cookie and storage access, and network interception expose local browser-control primitives, so the server should be connected only to MCP clients and agents that are trusted to use them.

Chrome, Chromium, or Microsoft Edge must be available, although the project supports automatic executable discovery. Supported operating environments include Windows, macOS, Linux, Docker, and CI environments. The project is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/stealth-browser-mcp/readme_

