/ 目录 / 演练场 / stealth-browser-mcp
● 社区 vibheksoni ⚡ 即开即用

stealth-browser-mcp

作者 vibheksoni · vibheksoni/stealth-browser-mcp

90-tool MCP browser automation that bypasses anti-bot systems — network hooks, UI cloning, and CDP control via natural language.

stealth-browser-mcp is an MCP server for undetectable browser automation using nodriver and Chrome DevTools Protocol. It provides 90 tools across 11 categories: browser management, element interaction, pixel-perfect UI cloning, network debugging with dynamic hooks, CDP functions, progressive cloning, cookies/storage, tabs, and page analysis. Bypasses Cloudflare and similar protections. Works with Claude, Cursor, and other MCP clients.

为什么要用

核心特性

实时演示

实际使用效果

stealth-browser-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "stealth-browser-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/vibheksoni/stealth-browser-mcp"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "stealth-browser-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/vibheksoni/stealth-browser-mcp"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "stealth-browser-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/vibheksoni/stealth-browser-mcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "stealth-browser-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/vibheksoni/stealth-browser-mcp"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "stealth-browser-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/vibheksoni/stealth-browser-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "stealth-browser-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/vibheksoni/stealth-browser-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add stealth-browser-mcp -- TODO 'See README: https://github.com/vibheksoni/stealth-browser-mcp'

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: stealth-browser-mcp

How to scrape data from a Cloudflare-protected site for authorized research

👤 Researchers and data analysts who need data from protected sites they have permission to access ⏱ ~15 min intermediate

何时使用: You need to extract data from a site you're authorized to access but standard scraping tools get blocked.

前置条件
  • stealth-browser-mcp installed — Clone repo, pip install -r requirements.txt
  • Authorization to access the target site — Ensure you have permission to scrape the site
步骤
  1. Navigate to the site
    Open a stealth browser and navigate to https://example.com/data. Wait for the page to fully load.✓ 已复制
    → Page loaded successfully, bypassing protection
  2. Extract data
    Query all elements matching the product listing cards. Extract titles, prices, and URLs.✓ 已复制
    → Structured data from the page

结果: Data extracted from the protected site for authorized analysis.

注意事项
  • Running too many concurrent browsers — Keep to 1-2 browser instances at a time to avoid detection patterns
搭配使用: filesystem

Clone a UI element pixel-perfect for design reference

👤 Frontend developers who want to study and replicate a UI pattern ⏱ ~10 min intermediate

何时使用: You see a UI component you like and want the complete HTML/CSS for reference.

前置条件
  • stealth-browser-mcp running — Start the MCP server
步骤
  1. Navigate and identify
    Open https://example.com and take a screenshot. I want to clone the navigation header.✓ 已复制
    → Screenshot with page rendered
  2. Clone the element
    Clone the nav header element completely — HTML structure, CSS styles, events, and animations. Save to a file.✓ 已复制
    → Complete element clone saved with all styles and assets

结果: A self-contained HTML/CSS clone of the UI element for reference.

注意事项
  • Cloned elements may depend on external fonts or scripts — Use extract_element_assets to also capture referenced resources
搭配使用: filesystem

组合

与其他 MCP 搭配,撬动十倍杠杆

stealth-browser-mcp + filesystem

Save scraped data and cloned UI elements to organized files

Scrape all product data from the page and save it as JSON to ~/data/products.json.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
spawn_browser options?: obj Launch a new stealth browser instance 0
navigate url: str Navigate to a URL 0
query_elements selector: str Find elements by CSS selector 0
clone_element_complete selector: str Pixel-perfect clone of a DOM element with all styles 0
create_dynamic_hook hook_function: str Create a Python function to intercept network traffic 0
take_screenshot selector?: str Capture a screenshot of the page or specific element 0
execute_script script: str Execute JavaScript in the page context 0

成本与限制

运行它的成本

API 配额
N/A — runs locally
每次调用 Token 数
200–2000 tokens per tool call
费用
Free
提示
Use core mode (22 tools) if your client struggles with the full 90-tool set.

安全

权限、密钥、影响范围

凭据存储: No credentials stored by the server. If accessing authenticated sites, manage cookies via get/set_cookie tools.
数据出站: Connects to whatever URLs you navigate to via Chrome

故障排查

常见错误与修复

Chrome not found

The server uses nodriver which manages its own Chrome. Ensure Chrome is installed or let nodriver download it.

验证: which google-chrome || which chromium
Anti-bot detection still triggered

Try adding delays between actions, reduce concurrent requests, or use different browser profiles.

验证: Check the page for CAPTCHA or block messages
Element clone incomplete

Some elements use shadow DOM or iframe isolation. Use execute_cdp_command for low-level access.

验证: Inspect the element in DevTools to check for shadow roots

替代方案

stealth-browser-mcp 对比其他方案

替代方案何时用它替代权衡
playwright MCPYou don't need anti-bot bypass and want standard browser automationStandard Playwright with no stealth features but broader community support

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills