🚀 MCP Stealth Browser (mcp-stealth-browser)

💡 Facing IP Bans, Zero-View Shadowbans, or Captcha Loops? Need custom dedicated residential IP pools or enterprise setup assistance? 🎁 Claim 1GB Free Residential Proxy Trial | 💬 Telegram Support: @ip38888 | ✉️ Email: anton.li.pm@gmail.com | 📊 Live Benchmark

⭐ Love this project? Please consider starring it on GitHub! It helps keep the open-source residential IP anti-bot benchmark updated.

🔥 Check Out Our High-Performance AI & Agentic Suite:

• 🤖 llm-web-grounding-proxy: Universal OpenAI reverse proxy injecting real-time search & citations.

• 🧠 agentic-deep-researcher: Autonomous AI deep researcher with recursive multi-hop scraping.

• 🌐 mcp-stealth-browser: FastMCP 2.x stealth browser server for Claude Desktop, Cursor & Windsurf.

• 🛡️ antidetect-proxy-router: Profile-isolated residential proxy router for Playwright & Camoufox.

The High-Performance Stealth Web Browsing & Search MCP Server for Claude Desktop, Cursor, Windsurf & Cline.
Bypasses Cloudflare Turnstile, anti-bot shields, and JavaScript SPAs with dual-engine TLS/Playwright impersonation, dynamic residential proxy rotation, and token-optimized semantic Markdown extraction.

🏛️ Architecture Overview

flowchart LR
    A[LLM Agent<br/>Claude / Cursor / Cline] -->|JSON-RPC 2.0| B(MCP Stealth Server)
    B -->|Task Router| C{Engine Dispatcher}
    C -->|Tier 1: Fast Path <400ms| D[TLS Impersonator<br/>curl_cffi / JA3 / JA4]
    C -->|Tier 2: Challenge Escalation| E[Stealth Playwright<br/>CDP Hooks + Turnstile Solver]
    D --> F[Sticky Residential Proxy Router<br/>Ropond Proxy Cloud]
    E --> F
    F -->|Clean IP Lease| G((Target Website))
    G --> H[Token Optimizer Engine<br/>HTML to Semantic Markdown]
    H -->|80-95% Token Savings| A

Related MCP server: Stealth Browser MCP Server

📊 Feature Comparison Matrix

⚡ Why mcp-stealth-browser?

Standard web fetch and browser MCP servers (@modelcontextprotocol/server-fetch, playwright-mcp) fail on 70%+ of modern websites:

• ❌ Cloudflare & Anti-Bot Blocking: Hit with 403 Forbidden or Just a moment... CAPTCHA loops.

• ❌ Token Window Explosion: Dump raw HTML with bloated scripts, SVGs, and cookie modals, wasting 100k+ tokens.

• ❌ IP Rate-Limits: Repeated queries from data center IPs get permanently blocked.

• ❌ No Native Multi-Engine Web Search: Requires expensive Bing/Google API keys to search the web.

🌟 What mcp-stealth-browser solves:

• ✅ Dual-Engine Cascade: Fast TLS/JA4 browser impersonation (<400ms) with auto-escalation to headless Playwright when Cloudflare Turnstile or DataDome is detected.

• ✅ Built-in Real-Time Web Search: stealth_search crawls Google & DuckDuckGo simultaneously with zero API keys.

• ✅ Token-Optimized Markdown: Strips navigation, headers, footers, and scripts, compressing content by 80-95% while preserving tables, headings, and code snippets.

• ✅ Sticky Residential Proxy Pool: Dynamic residential proxy rotation with 10-30 minute sticky IP sessions and automatic block recovery.

• ✅ Universal 1-Click Integration: Drop-in configuration for Claude Desktop, Cursor IDE, Windsurf, and Cline.

🛠️ MCP Tools Exposed

📦 Quick Start & Configuration

0. 1-Click Install via Smithery (Recommended)

To automatically install for Claude Desktop, run:

npx -y @smithery/cli install @AntonLi-PM/mcp-stealth-browser --client claude

To install for Cursor, run:

npx -y @smithery/cli install @AntonLi-PM/mcp-stealth-browser --client cursor

1. Manual Install via pip or uv

pip install git+https://github.com/AntonLi-PM/mcp-stealth-browser.git
# Optional: Install Playwright for heavy Turnstile challenge solving
playwright install chromium

2. Configure in Claude Desktop

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stealth-browser": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/AntonLi-PM/mcp-stealth-browser.git", "mcp-stealth-browser"],
      "env": {
        "ROTA_PROXY_URL": "http://user:pass@proxy.ropond.com:8080"
      }
    }
  }
}

3. Configure in Cursor IDE

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "stealth-browser": {
      "command": "python",
      "args": ["-m", "mcp_stealth_browser"],
      "env": {
        "ROTA_PROXY_URL": "http://user:pass@proxy.ropond.com:8080"
      }
    }
  }
}

🌐 Residential Proxy Setup (High-Volume Scraping)

For high-concurrency scraping without IP blocks, mcp-stealth-browser natively integrates with dynamic residential proxies:

1. Obtain a residential proxy gateway (claim a 1GB Free Trial at Ropond Proxy Cloud).

2. Set the environment variable:

export ROTA_PROXY_URL="http://customer-xyz:pass@gw.ropond.com:8080"

3. mcp-stealth-browser will automatically create sticky sessions per agent conversation and rotate automatically if a 403 or 429 block is encountered.

🧪 Testing Locally

You can test the search and fetch capabilities directly from CLI:

# Test multi-engine search
python -m mcp_stealth_browser.cli --test-search "DeepSeek R1 reasoning architecture"

# Test stealth fetch on a webpage
python -m mcp_stealth_browser.cli --test-fetch "https://news.ycombinator.com"

# Check proxy pool health
python -m mcp_stealth_browser.cli --status

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🧭 Related Open-Source Tools in Our Suite

Explore our complete production-grade anti-bot & matrix marketing open-source ecosystem: