stealth-browser-mcp
installs/mo · pypistarsforks
How to install stealth-browser-mcp?
vibheksoni/stealth-browser-mcp
$git clone https://github.com/vibheksoni/stealth-browser-mcpUndetectable browser automation for MCP-compatible AI agents.
README.md
| 1 | <div align="center"> |
| 2 | |
| 3 | <img src="media/UndetectedStealthBrowser.png" alt="Stealth Browser MCP" width="200"/> |
| 4 | |
| 5 | # Stealth Browser MCP |
| 6 | |
| 7 | **Undetectable browser automation for MCP-compatible AI agents.** |
| 8 | |
| 9 | Bypass Cloudflare, antibot systems, and social media blocks with real browser instances powered by [nodriver](https://github.com/ultrafunkamsterdam/nodriver) + Chrome DevTools Protocol + [FastMCP](https://github.com/jlowin/fastmcp). |
| 10 | |
| 11 | [](https://modelcontextprotocol.io) |
| 12 | [](https://github.com/vibheksoni/stealth-browser-mcp/stargazers) |
| 13 | [](LICENSE) |
| 14 | [](https://discord.gg/secrets) |
| 15 | [](CONTRIBUTING.md) |
| 16 | |
| 17 | </div> |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Table of Contents |
| 22 | |
| 23 | - [Demo](#demo) |
| 24 | - [Features](#features) |
| 25 | - [Quickstart](#quickstart) |
| 26 | - [Modular Architecture](#modular-architecture) |
| 27 | - [Toolbox](#toolbox) |
| 28 | - [Stealth vs Playwright MCP](#stealth-vs-playwright-mcp) |
| 29 | - [Troubleshooting](#troubleshooting) |
| 30 | - [Examples](#examples) |
| 31 | - [Showcase](#showcase) |
| 32 | - [Roadmap](#roadmap) |
| 33 | - [Contributing](#contributing) |
| 34 | - [Support](#support) |
| 35 | - [License](#license) |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Demo |
| 40 | |
| 41 | <div align="center"> |
| 42 | <img src="media/showcase-demo-full.gif" alt="Stealth Browser MCP Demo" width="800" style="border-radius: 8px;"> |
| 43 | <br><br> |
| 44 | <a href="media/Showcase%20Stealth%20Browser%20Mcp.mp4" download> |
| 45 | <img src="https://img.shields.io/badge/Watch%20HD%20Video-red?style=for-the-badge&logo=video&logoColor=white" alt="Watch HD Video"> |
| 46 | </a> |
| 47 | </div> |
| 48 | |
| 49 | *Stealth Browser MCP bypassing Cloudflare, cloning UI elements, and intercepting network traffic — all through AI chat commands.* |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | ## Features |
| 54 | |
| 55 | - **Antibot bypass** — Works on Cloudflare, Queue-It, and other protection systems that block traditional automation |
| 56 | - **97 tools across 11 sections** — From basic navigation to advanced CDP function execution |
| 57 | - **Modular loading** — Run the full 97-tool arsenal or a minimal 20-tool core; disable what you don't need |
| 58 | - **Pixel-accurate element cloning** — Extract complete elements with all CSS, DOM structure, events, and assets via CDP |
| 59 | - **Network interception** — Inspect every request, response, header, and payload through your AI agent |
| 60 | - **Dynamic hook system** — AI-generated Python functions that intercept and modify network traffic in real-time |
| 61 | - **Instant text input** — Paste large content via CDP or type with human-like keystrokes and newline support |
| 62 | - **Cross-platform** — Windows, macOS, Linux, Docker, and CI/CD pipelines with automatic environment detection |
| 63 | - **Browser support** — Chrome, Chromium, and Microsoft Edge (automatic detection) |
| 64 | - **Clean MCP integration** — No custom brokers or wrappers; works with Claude Code, Claude Desktop, Cursor, and any MCP client |
| 65 | |
| 66 | --- |
| 67 | |
| 68 | ## Quickstart |
| 69 | |
| 70 | ### 1. Clone and install |
| 71 | |
| 72 | ```bash |
| 73 | git clone https://github.com/vibheksoni/stealth-browser-mcp.git |
| 74 | cd stealth-browser-mcp |
| 75 | python -m venv venv |
| 76 | |
| 77 | # Activate virtual environment |
| 78 | # Windows: |
| 79 | venv\Scripts\activate |
| 80 | # Mac/Linux: |
| 81 | source venv/bin/activate |
| 82 | |
| 83 | pip install -r requirements.txt |
| 84 | ``` |
| 85 | |
| 86 | ### 2. Add to your MCP client |
| 87 | |
| 88 | **Claude Code CLI (recommended):** |
| 89 | |
| 90 | Windows: |
| 91 | ```bash |
| 92 | 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\"]}" |
| 93 | ``` |
| 94 | |
| 95 | Mac/Linux: |
| 96 | ```bash |
| 97 | claude mcp add-json stealth-browser-mcp '{ |
| 98 | "type": "stdio", |
| 99 | "command": "/path/to/stealth-browser-mcp/venv/bin/python", |
| 100 | "args": ["/path/to/stealth-browser-mcp/src/server.py"] |
| 101 | }' |
| 102 | ``` |
| 103 | |
| 104 | > Replace `/path/to/stealth-browser-mcp/` with your actual project path. |
| 105 | |
| 106 | <details> |
| 107 | <summary><strong>Manual JSON configuration (Claude Deskt |
People who liked this also viewed
6 picksType
- playwright-mcpPlaywright MCP fork that works with Cloudflare Browser RenderingMCP ServersApr 2026
- Playwright MCPBrowser automation for agents via accessibility snapshotsMCP Servers6 days ago
- chrome-devtools-mcpChrome DevTools for coding agentsMCP ServersJul 2026
- browser-operator-coreBrowser Operator - The AI browser with built in Multi-Agent platform! Open source alternative to ChatGPT Atlas, Perplexity Comet, Dia and Microsoft CoPilot Edge BrowserMCP ServersMar 2026
- fetcher-mcpMCP server for fetch web page content using Playwright headless browser.MCP ServersJan 2026
- mcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browserMCP ServersApr 2025
