convez.ai
MCP ServerAutomaçãoAvançado
RobithYusuf

MCP Stealth Chrome

RobithYusuf/mcp-stealth-chrome

Bypass Cloudflare, Turnstile e reCAPTCHA com 133+ ferramentas stealth para agentes

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP com 133+ ferramentas para agentes de IA contornarem sistemas anti-bot (Cloudflare, Turnstile, reCAPTCHA). Combina navegação stealth via nodriver, spoofing de fingerprint TLS com curl_cffi e solucionador de CAPTCHA baseado em visão de IA. Otimizado para automação de alto nível com ações como `describe_page`, `smart_fill` e `workflow_run`.

Instalação

$npx convez-ai RobithYusuf/mcp-stealth-chrome

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
29
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 4 dias
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Automação de web scraping em sites com proteção anti-bot
  • Bypass de Cloudflare Turnstile e reCAPTCHA v2 com IA
  • Testes de detecção de headless browser e fingerprinting
  • Automação de fluxos complexos em aplicações web protegidas

Veredito

Ferramenta especializada e comprovada em campo para contornar proteções anti-bot. Requer conhecimento técnico sólido de automação web e ética clara sobre uso legítimo. Stack moderno e bem documentado, mas adequado apenas para casos específicos de automação legítima.

README

A tradução para o português deste README ainda está na fila.

MCP Stealth Chrome

133 tools for AI agents that bypass Cloudflare, Turnstile, reCAPTCHA, and modern anti-bot systems — with an LLM-optimized action kit (describe_page, smart_fill, workflow_run, vision-LLM element locator) layered on top of standard automation.

PyPI version License: MIT Python 3.11+

Browser stealth when you need eyes. TLS-perfect HTTP when you need speed.


Built on nodriver (direct CDP, no WebDriver leak) + curl_cffi (TLS fingerprint spoofing) + FastMCP.

One-line install with uvx:

claude mcp add stealth-chrome -- uvx mcp-stealth-chrome@latest

Proven on Real Sites

SiteChallengeResult
bot.sannysoft.comAll fingerprint tests✅ 100% pass (proof)
2captcha.com/demo/cloudflare-turnstileTurnstile visible✅ Passed via click_turnstile() (proof)
arh.antoinevastel.com/.../areyouheadlessHeadless-chrome detection✅ "You are not Chrome headless" (proof)
browserscan.net/bot-detectionWebDriver/Selenium/CDP/Headless✅ All categories "Normal" (proof)
tls.browserleaks.comTLS JA3/JA4 fingerprint✅ Real Chrome/Firefox/Safari JA3 hashes (see output below)
httpbin.orgMulti-instance isolation✅ Two browsers parallel
google.com/recaptcha/api2/demoreCAPTCHA v2 image challenge✅ 5/5 = 100% via solve_recaptcha_ai() (proof)

🎯 click_turnstile → Cloudflare Turnstile Bypass

One-liner bypass on supported widget shapes. click_turnstile() → checkbox switches from "Verify you are human" ☐ to "Success!" ✅.

✅ Works on: 2captcha.com/demo/cloudflare-turnstile, dash.cloudflare.com login, nopecha.com/captcha/turnstile (via template-match fallback since v0.1.7), any page embedding the standard CF Turnstile widget with [data-sitekey] / .cf-turnstile / challenges.cloudflare.com iframe.

❌ Does NOT work on: Cloudflare managed-mode interstitials — the "Just a moment..." full-page challenge (e.g. nopecha.com/demo/cloudflare). CF scores the click as non-human and resets the Ray ID. For those pages use solve_captcha with a CAPSOLVER_KEY, or storage_state_load with a pre-warmed session.

🧪 bot.sannysoft.com → All Fingerprint Tests Pass

navigator.webdriver missing, WebDriver Advanced passed, Chrome present, Plugins detected correctly, PHANTOM_* probes all ok, WebGL shows real Apple M1 Pro GPU — nodriver's CDP-direct approach leaves zero automation traces.

🤖 areyouheadless → Headless Chrome Detection

Antoine Vastel's public headless-detection test says "You are not Chrome headless" — even though we run Chrome controlled programmatically.

🔍 browserscan.net/bot-detection → All Categories Normal

14 signals checked (WebDriver, WebDriver Advance, Selenium, NightmareJS, PhantomJS, Awesomium, Cef, CefSharp, Coaches, FMiner, Born, Phantomas, Rhino, Webdriverio, Headless Chrome, CDP, Dev Tool, Native Navigator) — every one returns "Normal".

🔐 TLS Fingerprint Proof

http_request(impersonate="chrome") vs vanilla Python httpx — tls.browserleaks.com:

Vanilla httpx:       JA3: 37f7d09ced1a845dc48872abc1a29d7b   UA: python-httpx/0.28.1    ❌ BOT
Chrome impersonate:  JA3: f830262a93191fd695c65531282d5657   UA: Chrome/146.0.0.0         ✅ real Chrome
Firefox impersonate: JA3: 6f7889b9fb1a62a9577e685c1fcfa919   UA: Firefox/147.0            ✅ real Firefox
Safari impersonate:  JA3: ecdf4f49dd59effc439639da29186671   UA: Safari/605.1.15          ✅ real Safari

Each impersonation produces authentic browser JA3/JA4 — Cloudflare, DataDome, and Akamai cannot distinguish our HTTP requests from real browsers.

🏆 reCAPTCHA v2 Benchmark (5 consecutive runs)

Fresh profile + mouse drift warmup + an OpenAI-compatible vision model:

Run 1: ✅ 2169ch token, tiles=[3,4,7],         146s
Run 2: ✅ 2126ch token, tiles=[0,2,4,7],        80s
Run 3: ✅ 2169ch token, tiles=[1,2,4,8],       143s
Run 4: ✅ 2148ch token, tiles=[1,4,5,6,8,9],  126s
Run 5: ✅ 2169ch token, tiles=[0,3,4],          69s

Success rate: 5/5 = 100%
Avg solve:   113s
Token range: 2126–2169 chars (all Google-accepted)

First OSS MCP with proven 100% reCAPTCHA v2 bypass via BYO-API-key — works with Claude, gpt-4o, gpt-5.x, Gemini, Groq, local Ollama, any OpenAI-compatible vision model.

Method: neutral prompt language bypasses LLM safety filter + auto-refresh challenge when vision returns empty + dynamic 3x3/4x4 grid detection + humanized mouse behavior.

Key Differentiators

Compared to the leading Python stealth MCP (vibheksoni/stealth-browser-mcp, 476⭐):

Featuremcp-stealth-chromevibheksoni
Tools13390
LLM-optimized kit (describe_page, smart_fill, vision_locate, workflow_run, assert_*)✅ Unique❌
Network body capture + session-bridged HTTP✅ Unique❌
click_turnstile one-liner✅ Embed widgets + template fallback❌
Dual-mode HTTP (curl_cffi TLS)✅ Unique❌
AI Vision reCAPTCHA solver (Claude)✅ Unique❌
Precision Mouse Kit (11 tools)✅ Unique❌
Multi-instance + idle reaper✅✅
Installuvx zero-setupgit clone + pip
Sister Firefox package✅ mcp-camoufox❌
Network interception hooks⚠️ basic✅ AI-generated Python hooks
Pixel-perfect element cloning⚠️ basic✅ 300+ CSS + events

Different niches: we focus on anti-bot bypass, they focus on UI reverse-engineering. Both MCPs work great together.

Quick Install (3 commands per OS)

macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh        # install uv
brew install --cask google-chrome                       # install Chrome (skip if already installed)
claude mcp add stealth-chrome --scope user -- uvx mcp-stealth-chrome@latest

Linux (Ubuntu/Debian):

curl -LsSf https://astral.sh/uv/install.sh | sh
sudo apt install -y google-chrome-stable                # or chromium-browser
claude mcp add stealth-chrome --scope user -- uvx mcp-stealth-chrome@latest

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
winget install Google.Chrome
claude mcp add stealth-chrome --scope user -- uvx mcp-stealth-chrome@latest

No Chrome? Server gives a friendly error with install instructions before failing.

See INSTALL.md for detailed per-client setup + troubleshooting. Per-client snippets below:

Global (available in all projects):

claude mcp add stealth-chrome --scope user -- uvx mcp-stealth-chrome@latest

Project only (current project):

claude mcp add stealth-chrome -- uvx mcp-stealth-chrome@latest

Global — add to config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "stealth-chrome": {
      "command": "uvx",
      "args": ["mcp-stealth-chrome@latest"]
    }
  }
}

Claude Desktop is always global — no project-level config.

Global — Preferences > Features > MCP, or ~/.cursor/mcp.json:

Project — .cursor/mcp.json in project root:

{
  "mcpServers": {
    "stealth-chrome": {
      "command": "uvx",
      "args": ["mcp-stealth-chrome@latest"]
    }
  }
}

Global — ~/.windsurf/mcp.json:

Project — .windsurf/mcp.json in project root:

{
  "servers": {
    "stealth-chrome": {
      "command": "uvx",
      "args": ["mcp-stealth-chrome@latest"]
    }
  }
}

Global — VS Code settings or ~/.continue/config.json:

Project — .vscode/mcp.json in project root:

{
  "mcpServers": {
    "stealth-chrome": {
      "command": "uvx",
      "args": ["mcp-stealth-chrome@latest"]
    }
  }
}

Settings → Extensions → MCP Servers, or edit ~/.config/zed/settings.json:

{
  "context_servers": {
    "stealth-chrome": {
      "command": {
        "path": "uvx",
        "args": ["mcp-stealth-chrome@latest"]
      }
    }
  }
}

🔑 BYOK (Bring Your Own Key) — Optional

mcp-stealth-chrome is fully functional without any API key — 130 of 133 tools work out of the box, including click_turnstile (Cloudflare Turnstile bypass), TLS-perfect HTTP, multi-instance, DevTools-level perf/coverage/emulation, the full LLM-optimized kit (describe_page / smart_fill / workflow_run), and all scraping tools.

API keys are optional — only needed for 3 vision/solver tools:

ToolPurposeRequired keyCost
solve_recaptcha_aireCAPTCHA v2 image challenges via AI visionAny vision-capable LLM (OpenAI-compat / Claude / Ollama)~$0.005-0.03 per solve
vision_locateFind DOM element by natural-language description ("the red Create button at bottom right")Same vision provider as solve_recaptcha_ai~$0.001-0.01 per call
solve_captchaTurnstile, reCAPTCHA v2, reCAPTCHA v3, hCaptcha via paid solverCapSolver API~$0.80-1.00 per 1000

Everything else (click_turnstile, verify_cf, storage_state, http_request, detect_anti_bot, clone_chrome_profile, etc.) works 100% without any key.

When BYOK Matters

  • solve_recaptcha_ai → auto-solve reCAPTCHA v2 image challenges ("select all images with cars") via vision LLM. Best for: low-volume automation where you want self-hosted / BYO-key.
  • solve_captcha → solve via CapSolver's dedicated captcha-solving service. Best for: production reliability, high success rate (95%+), handles multiple types (Turnstile + reCAPTCHA v2 + v3 + hCaptcha + more).

You can use either one or both depending on your budget and reliability needs. Add to the MCP env block.

⚠️ Model Must Be Multimodal (Vision-Capable)

solve_recaptcha_ai sends a screenshot + text prompt to the model — text-only models will fail silently.

✅ Vision-capable (supported):

  • OpenAI: gpt-4o, gpt-4o-mini, gpt-4-vision-preview, gpt-5.x
  • Anthropic: claude-opus-4-7, claude-sonnet-4-*
  • Local Ollama: llava, llava-llama3, bakllava, llama3.2-vision
  • Groq: llama-3.2-90b-vision-preview
  • Custom: any model documented as "multimodal" / "vision"

❌ Text-only (NOT supported):

  • gpt-3.5-turbo, llama3 (non-vision variant), claude-3-haiku (limited)

Config Options

{
  "mcpServers": {
    "stealth-chrome": {
      "command": "uvx",
      "args": ["mcp-stealth-chrome@latest"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-xxxxx",
        "ANTHROPIC_MODEL":   "claude-opus-4-7"
      }
    }
  }
}

Get key at console.anthropic.com.

"env": {
  "OPENAI_API_KEY": "sk-proj-xxxxx",
  "OPENAI_MODEL":   "gpt-4o"
}

Get key at platform.openai.com.

"env": {
  "OPENAI_BASE_URL": "https://your-provider.example.com/v1",
  "OPENAI_API_KEY":  "your-api-key",
  "OPENAI_MODEL":    "model-name-that-supports-vision"
}

Uses OpenAI SDK standard env names (OPENAI_API_KEY, OPENAI_BASE_URL). Works with any provider exposing /v1/chat/completions with image_url content support.

Example — Groq:

"env": {
  "OPENAI_BASE_URL": "https://api.groq.com/openai/v1",
  "OPENAI_API_KEY":  "gsk_xxxxx",
  "OPENAI_MODEL":    "llama-3.2-90b-vision-preview"
}
ollama pull llava
"env": {
  "OPENAI_BASE_URL": "http://localhost:11434/v1",
  "OPENAI_API_KEY":  "ollama",
  "OPENAI_MODEL":    "llava:latest"
}

Fully offline, no cost. Accuracy varies by model.

"env": {
  "CAPSOLVER_KEY": "CAP-xxxxxxxxxxxxx"
}

Enables solve_captcha tool. ~$0.80/1000 solves for Turnstile. Get key at capsolver.com.

Provider Resolution Priority

  1. Explicit args to solve_recaptcha_ai(provider=, base_url=, api_key=, model=)
  2. OPENAI_API_KEY + OPENAI_BASE_URL + OPENAI_MODEL — standard (OpenAI SDK convention)
  3. AI_VISION_API_KEY + AI_VISION_BASE_URL + AI_VISION_MODEL — deprecated (removed in v0.2.0)
  4. ANTHROPIC_API_KEY + ANTHROPIC_MODEL — Claude

Legacy AI_VISION_* env still work but emit DeprecationWarning. Migrate to OPENAI_* standard for future compatibility.

Requirements

  • Python 3.11+
  • uv installed: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Chrome or Chromium browser (auto-detected by nodriver)

Tool Categories (133)

⭐⭐⭐ Dual-Mode HTTP (unique)

ToolPurpose
http_requestTLS-perfect HTTP via curl_cffi (chrome/firefox/safari impersonation)
http_session_cookiesInspect which browser cookies match a URL
session_warmupNatural browsing pattern (homepage/referer/scroll) before target
detect_anti_botIdentify CF/DataDome/PerimeterX/Kasada/Imperva on current page

⭐⭐ Precision Mouse Kit (unique)

ToolPurpose
click_turnstileCF Turnstile bypass for embed widgets + template-match fallback
click_element_offsetClick at % position inside element (not center)
click_at_cornerClick top-left/right/bottom-left/right of element
find_by_imageOpenCV template match → coordinates
click_at_imageFind image + click its center
mouse_driftRandom Bezier wandering (pass behavioral ML)
mouse_record / mouse_replayCapture real human mouse patterns, replay

⭐⭐ AI Vision Solver (unique)

ToolPurpose
solve_recaptcha_aiVision LLM picks matching tiles — solve image challenges (auto-clicks anchor checkbox in v0.2.10+)
vision_locateNL → element coordinates: "the red Create button at bottom right" (optional click=True)

⭐⭐⭐ AI-Agent Action Kit (LLM-optimized, new in v0.3.0)

Designed for LLM-driven workflows — token-efficient page summaries, label-fuzzy form filling, verification primitives, resumable orchestration.

ToolPurpose
describe_pageCompact JSON summary (title/url/headings/fields/actions/errors/navigation) — ~10× fewer tokens than accessibility_snapshot. wait_stable=True waits for SPA hydration via MutationObserver
smart_fillFill form by label text (fuzzy match: exact > prefix > substring > token); native value setter for React/Vue. Returns did_you_mean candidates on miss
paste_textFull paste-event sequence (ClipboardEvent + DataTransfer + beforeinput inputType:'insertFromPaste') for SolidJS/Svelte 5/Qwik forms that ignore plain dispatchEvent('input')
assert_text_present / assert_url_matches / assert_element_visibleVerification primitives with internal poll-loop
click_and_waitClick + observe one of navigation / url / text / selector / request / network_idle. Distinguishes real submit from silent invalid-form click
form_introspectPer-field detail (label, framework binding react/vue/solid/lit, validation state, pattern/length constraints, aria-invalid)
workflow_runSequential tool runner with resumable start_at index and stop_on_error. Failure response includes failure_context and resume_with hint
storage_snapshot / storage_diffSnapshot cookies + localStorage + sessionStorage + url to a named slot, then diff after an action — debug "what did this click actually change?"
detect_and_bypassOne-shot: detect anti-bot wall (CF / DataDome / PX / Akamai / Imperva / Kasada) and apply best bypass we have

⭐⭐ Network + Auth Bridge (new in v0.4.0)

Network capture with response bodies, plus a bridge from browser session into TLS-perfect HTTP for authenticated API debugging.

ToolPurpose
network_start(capture_bodies=True) + network_get(include_body=True)Index every request by request_id and lazy-fetch response bodies via CDP Network.getResponseBody (truncated, configurable)
auth_captureIntercept the next N requests matching a URL pattern and return their headers (Authorization, Cookie, X-CSRF-*) — for SPAs that hold bearer tokens in JS memory
http_request_with_sessionAuthenticated curl_cffi request that piggybacks on browser cookies + auto-extracts most recent same-host bearer from network_index
wait_for_requestBlock until a request matching url_pattern is observed (+ optional method filter, + optional response wait) — replaces setTimeout polling
dialog_auto_handlePersistent native-dialog handler with type filter (alert / confirm / prompt / beforeunload). Update action without re-arming. Idempotent per tab

⭐ Stealth Toolkit

ToolPurpose
storage_state_save / storage_state_loadPortable session export — bypass Turnstile via reuse
solve_captchaCapSolver API — Turnstile/reCAPTCHA/hCaptcha
verify_cfCloudflare checkbox via OpenCV template match
fingerprint_rotateUA/lang/platform/timezone via CDP
humanize_click / humanize_typeBezier+Gaussian for single actions

Multi-Instance

ToolPurpose
spawn_browserNew named instance (parallel profiles)
list_instances / switch_instanceManage multiple browsers
close_instance / close_all_instancesClean shutdown

⭐⭐ DevTools Suite — perf, coverage, emulation (new in v0.2.0)

ToolPurpose
performance_trace_start / performance_trace_stopCDP Tracing — save .json, drop into chrome://tracing or DevTools Performance panel
performance_metricsRuntime Performance.getMetrics (Nodes, JSHeap, TaskDuration, FPS…)
performance_timelineTTFB / FCP / DOMContentLoaded / load + slowest 5 resources (instant, no trace capture)
web_vitalsCore Web Vitals via web-vitals v4 — LCP/CLS/INP/FCP/TTFB with pass/fail ratings
coverage_start / coverage_stopJS + CSS precise coverage — % unused bytes per file
memory_heap_snapshotV8 .heapsnapshot — drag into DevTools Memory panel
emulate_networkPreset throttles (offline / slow-3g / 3g / slow-4g / 4g / wifi) + custom
emulate_cpu1–6× CPU throttle (4× = DevTools default, 6× = low-end mobile)
emulate_deviceDevice presets: iphone-15, iphone-se, pixel-8, galaxy-s23, ipad, desktop
wait_for_network_idleSPA-safe load detection — waits for N ms of no fetch/XHR activity
console_clearReset captured console buffer

⚡ Performance optimizations

FeatureWhat it does
browser_snapshot(mode="fast")Skip getComputedStyle + minimal attrs (2–3× faster)
browser_snapshot(mode="viewport")Only elements inside current scroll viewport (5–10× on long pages)
browser_snapshot(diff_from_last=True)Cache DOM hash — near-instant if page unchanged
screenshot(format="jpeg", quality=60)JPEG vs PNG — ~3× smaller file
screenshot(region={x,y,width,height})Clip via CDP — 2–5× faster for small crops
browser_launch(testing_mode=True)Disable images / background throttling / translate — 2–5× faster nav for perf tests (not for stealth)

Standard Browser Automation (lifecycle/navigation/DOM/interaction/scraping)

CountExamples
Lifecycle: 2browser_launch, browser_close
Navigation: 4navigate, go_back, go_forward, reload
DOM/Content: 6browser_snapshot, screenshot, get_text, get_html, get_url, save_pdf
Interaction: 9click, click_text, click_role, hover, fill, select_option, check, uncheck, upload_file
Keyboard: 2type_text, press_key
Mouse: 3mouse_click_xy, mouse_move, drag_and_drop
Wait: 5wait_for, wait_for_navigation, wait_for_url, wait_for_response, wait_for_request
Tabs: 4tab_list, tab_new, tab_select, tab_close
Cookies: 5cookie_list/set/delete, cookie_import (+ raw_text auto-detect), cookie_export
Storage: 9localstorage_get/set/clear, sessionstorage_get/set/clear, cache_clear, indexeddb_list/delete
JavaScript: 2evaluate, inject_init_script
Inspection: 4inspect_element, get_attribute, query_selector_all, get_links
Frames: 2list_frames, frame_evaluate
Batch: 3batch_actions, fill_form, navigate_and_snapshot
Viewport/Scroll: 4get/set_viewport_size, scroll, scroll_to
Dialog: 2dialog_handle, dialog_auto_handle
A11y: 1accessibility_snapshot
Console/Network: 4console_start/get, network_start/get
Debug: 3server_status, get_page_errors, export_har
Scraping: 4detect_content_pattern, extract_structured, extract_table, scrape_page
Chrome profile integration: 2list_chrome_profiles, clone_chrome_profile

Example Workflows

One-liner Cloudflare Turnstile bypass (embed widget)

browser_launch(url="https://site-with-turnstile.com")
mouse_drift(duration_seconds=2)                    # natural behavior
click_turnstile()                                  # works on embedded widgets
# Login button now enabled, fill form, submit

Works on pages that embed the CF Turnstile widget (.cf-turnstile, [data-sitekey], or a challenges.cloudflare.com iframe). For managed-mode interstitials ("Just a moment..." full-page challenges), this tool cannot bypass — use solve_captcha or storage_state_load instead.

Bypass Turnstile via saved session (most reliable)

# Once — manual:
browser_launch(url="https://target.com/login", headless=false)
# [user logs in manually in browser window]
storage_state_save(filename="target-session.json")
browser_close()

# Every time after — automated:
browser_launch(
  url="https://target.com/dashboard",
  headless=true,                                   # can go headless
  storage_state_path="~/.mcp-stealth/storage-states/target-session.json"
)
# Turnstile never triggers — session is valid

Solve reCAPTCHA v2 image challenge via Claude

browser_launch(url="https://site-with-recaptcha.com")
click_element_offset(ref="recaptcha-checkbox-ref", x_percent=8)
# Image challenge appears
solve_recaptcha_ai(max_rounds=3)                   # uses ANTHROPIC_API_KEY
# Token injected, form ready to submit

Multi-account scraping in parallel

browser_launch(url="https://site.com", headless=true)   # main instance
spawn_browser("account_2", url="https://site.com", headless=true)
spawn_browser("account_3", url="https://site.com", headless=true)

list_instances()                                   # see all 3 running
switch_instance("account_2")
# All subsequent tool calls target account_2
click(ref="login-btn")
...
switch_instance("main")                            # back to main

Browser login + fast API scraping

# Login with browser (renders JS, solves challenges)
browser_launch(url="https://api-site.com/login")
click_turnstile()
fill(ref="email-ref", value="you@example.com")
fill(ref="password-ref", value="...")
click(ref="submit-ref")

# Scrape API 10x faster with TLS-perfect HTTP
http_request(
  url="https://api-site.com/v1/data",
  impersonate="chrome",
  use_browser_cookies=true                         # reuse login session
)

Auto-detect anti-bot + recommended strategy

browser_launch(url="https://unknown-site.com")
detect_anti_bot()
# Returns: {"detected": ["Cloudflare", "reCAPTCHA"],
#           "recommended_tools": [...]}

Architecture

uvx mcp-stealth-chrome → Python 3.11 → FastMCP → nodriver → Chrome/Chromium
                                                  ↓
                                          curl_cffi (TLS)

Data locations:

  • Profile (main): ~/.mcp-stealth/profile/
  • Profiles (multi-instance): ~/.mcp-stealth/profiles/<instance_id>/
  • Screenshots: ~/.mcp-stealth/screenshots/
  • Exports (PDF, HAR): ~/.mcp-stealth/exports/
  • Storage states: ~/.mcp-stealth/storage-states/

Environment Variables

VariableDefaultPurpose
BROWSER_IDLE_TIMEOUT600Auto-close browsers after idle seconds (0 = never)
BROWSER_IDLE_REAPER_INTERVAL60How often reaper checks idle state
CAPSOLVER_KEY—Enable solve_captcha tool
OPENAI_API_KEY—OpenAI-compat solve_recaptcha_ai (standard)
OPENAI_BASE_URLhttps://api.openai.com/v1Custom endpoint (Groq, Together, Ollama, etc.)
OPENAI_MODELgpt-4oVision-capable model name (required multimodal)
ANTHROPIC_API_KEY—Claude solve_recaptcha_ai
ANTHROPIC_MODELclaude-opus-4-7Claude model name

Deprecated (still work but emit DeprecationWarning — migrate to OpenAI standards above): AI_VISION_BASE_URL, AI_VISION_API_KEY, AI_VISION_MODEL, AI_VISION_PROVIDER

Stealth Details

Underlying tech stack:

  • nodriver — Python CDP client with no WebDriver/Runtime.Enable leaks
  • curl_cffi — libcurl with CFFI, matches Chrome/Firefox/Safari TLS handshake exactly (JA3/JA4 authenticity)
  • OpenCV — template matching for visual CAPTCHA checkbox detection

Bypass layer vs detection:

DetectionBypass
navigator.webdrivernodriver doesn't set it
Runtime.Enable CDP leaknodriver avoids it
Automation flagsNo --enable-automation
Headless fingerprintheadless=false recommended for hard targets
TLS/JA3/JA4http_request(impersonate='chrome')
Turnstile checkboxclick_turnstile()
reCAPTCHA v2 imagesolve_recaptcha_ai() or solve_captcha()
Behavioral MLmouse_drift, mouse_record/replay, humanize_click/type

Honest limits — these are HARDEST OSS bypass targets and require commercial services for production:

  • DataDome (real-time behavioral ML across 50+ signals)
  • Kasada (proprietary JS, rotates daily)
  • PerimeterX/HUMAN (ML-based request scoring)
  • ChatGPT managed Turnstile (checks React internal state)

For these, storage_state_save/load (manual-login-once, reuse) is the most reliable OSS approach.

Sister Package

mcp-camoufox — Firefox stealth with same API. Use when you need:

  • Hardest anti-bot bypass (Camoufox C++ level patches = stealth score 6% CreepJS)
  • Firefox-specific rendering
  • Node.js ecosystem

Both packages share tool names, snapshot format, ref system — switch seamlessly.

Development

git clone https://github.com/RobithYusuf/mcp-stealth-chrome
cd mcp-stealth-chrome
uv sync
uv run mcp-stealth-chrome       # run stdio server locally

Testing:

uv run python /tmp/smoke-test.py      # full smoke test (see /tmp/ examples)

Credits

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados