隐形浏览器自动化工具

隐形浏览器MCP

🚀 唯一绕过Cloudflare、反垃圾邮件和社交媒体阻止的浏览器自动化

为任何与MCP兼容的AI代理提供不可检测的、真正的浏览器自动化。没有验证码。没有障碍。只是结果。

🌐 实时部署

✅ 生产就绪: https://stealth-browser-mcp.onrender.com
🔍 健康检查: /mcp 端点
📡 运输：服务器发送事件（SSE）
🚀 准备好了：OpenAI Playground、Claude和其他MCP客户端

⚡ 30秒设置•🛡️ 设计无法检测•🏆 在受保护地点的成功率为98.7%🕵️ 通过AI聊天进行全面网络调试

为您的AI代理提供真正的浏览器超能力：访问Cloudflare网站，提取任何UI，并拦截网络流量——来自您的聊天室。

🎥 在行动中看到它

🎯 手表：绕过Cloudflare的隐形浏览器MCP、克隆UI元素和拦截网络流量——所有这些都是通过简单的AI聊天命令完成的

🔗 快速链接

• ▶️ 快速启动
• 🏆 名人堂 -不可能的自动化成为可能
• 🥊 隐形与其他 -我们为何在竞争中占据主导地位
• 🔥 病毒实例 -复制和粘贴令人震惊的提示
• 🧰 90工具 -完整的浏览器自动化库
• 🎥 现场演示 -看到它绕过了别人做不到的东西
• 🤝 贡献 & 💬 Discord 的中文翻译是“不和谐”或“纷争”。

快速启动（60秒）

✅ 推荐设置（创建者测试方法）

# 1. Clone the repository
git clone https://github.com/vibheksoni/stealth-browser-mcp.git
cd stealth-browser-mcp

# 2. Create virtual environment
python -m venv venv

# 3. Activate virtual environment
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate

# 4. Install dependencies
pip install -r requirements.txt

# 5. Add to Claude Code using CLI

Windows（完整安装）：

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\"]}"

Windows（仅限核心工具）：

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\",\"--minimal\"]}"

Mac/Linux（完整安装）：

claude mcp add-json stealth-browser-mcp '{
  "type": "stdio",
  "command": "/path/to/stealth-browser-mcp/venv/bin/python",
  "args": [
    "/path/to/stealth-browser-mcp/src/server.py"
  ]
}'

Mac/Linux（自定义-禁用高级功能）：

claude mcp add-json stealth-browser-mcp '{
  "type": "stdio",
  "command": "/path/to/stealth-browser-mcp/venv/bin/python",
  "args": [
    "/path/to/stealth-browser-mcp/src/server.py",
    "--disable-cdp-functions",
    "--disable-dynamic-hooks"
  ]
}'

💡 替换 /path/to/stealth-browser-mcp/ 使用您的实际项目路径

⚠️ 替代方案：FastMCP CLI（未经创建者测试）

这些方法理论上应该有效，但尚未经过创建者的测试。使用风险自负。

# Install FastMCP
pip install fastmcp

# Auto-install (untested)
fastmcp install claude-desktop src/server.py --with-requirements requirements.txt
# OR
fastmcp install claude-code src/server.py --with-requirements requirements.txt  
# OR
fastmcp install cursor src/server.py --with-requirements requirements.txt

替代方案：手动配置（如果Claude CLI不可用）

如果您没有Claude Code CLI，请手动添加到MCP客户端配置中：

克劳德桌面-Windows (%APPDATA%\Claude\claude_desktop_config.json)

{
  "mcpServers": {
    "stealth-browser-full": {
      "command": "C:\\path\\to\\stealth-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\stealth-browser-mcp\\src\\server.py"],
      "env": {}
    },
    "stealth-browser-minimal": {
      "command": "C:\\path\\to\\stealth-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\stealth-browser-mcp\\src\\server.py", "--minimal"],
      "env": {}
    }
  }
}

克劳德桌面-Mac/Linux (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "stealth-browser-full": {
      "command": "/path/to/stealth-browser-mcp/venv/bin/python",
      "args": ["/path/to/stealth-browser-mcp/src/server.py"],
      "env": {}
    },
    "stealth-browser-custom": {
      "command": "/path/to/stealth-browser-mcp/venv/bin/python",
      "args": [
        "/path/to/stealth-browser-mcp/src/server.py",
        "--disable-cdp-functions",
        "--disable-dynamic-hooks"
      ],
      "env": {}
    }
  }
}

🎛️ 新增：自定义安装

Stealth Browser MCP现在支持模块化工具加载！禁用不需要的部分：

# Minimal installation (only core browser + element interaction)
python src/server.py --minimal

# Custom installation - disable specific sections
python src/server.py --disable-cdp-functions --disable-dynamic-hooks

# List all 11 available tool sections
python src/server.py --list-sections

可用部分：

• browser-management （11个工具）-核心浏览器操作
• element-interaction （11个工具）-页面交互和操作
• element-extraction （9个工具）-元素克隆和提取
• file-extraction （9个工具）-基于文件的提取工具
• network-debugging （5个工具）-网络监控和拦截
• cdp-functions （13个工具）-Chrome DevTools协议执行
• progressive-cloning （10个工具）-高级元素克隆
• cookies-storage （3个工具）-Cookie和存储管理
• tabs （5个工具）-选项卡管理
• debugging （6个工具）-调试和系统工具（包括新的环境验证器）
• dynamic-hooks （10个工具）-AI驱动的网络挂钩

💡 专业提示：使用 --minimal 适用于轻量级部署或 --disable-* 标记以排除您不需要的功能！

快速测试

重新启动MCP客户端并询问您的代理：

“使用隐形浏览器导航到https://example.com并提取定价表。"

🚨 常见安装问题

❌ 错误：找不到满足要求[package]的版本

• 解决方案：确保您的虚拟环境已激活： venv\Scripts\activate （Windows）或 source venv/bin/activate （Mac/Linux）
• 替代：请先尝试升级pip： pip install --upgrade pip

❌ 运行服务器时未发现模块错误

• 解决方案：确保在运行之前激活虚拟环境
• 检查路径：确保Claude CLI命令使用正确的venv路径

❌ Chrome/浏览器问题

• 解决方案：首次运行时，服务器将自动下载Chrome
• 无需手动安装Chrome

❌ “无法连接到浏览器”/Root用户问题

• 解决方案: ✅ 在v0.2.4中已修复！ 自动检测root/管理员并添加 --no-sandbox 自动地
• 手动修复：添加 "args": ["--no-sandbox", "--disable-setuid-sandbox"] 拨打spawn_browser电话
• 诊断工具：使用 validate_browser_environment_tool() 检查您的环境

❌ 带有args参数的“输入验证错误”

• 解决方案: ✅ 在v0.2.4中已修复！ 现在接受JSON数组和JSON字符串：
  • "args": ["--no-sandbox"] （首选）
  • "args": "[\"--no-sandbox\"]" （也有效）

❌ 容器/Docker问题

• 解决方案: ✅ 在v0.2.4中已修复！ 自动检测容器并添加所需参数
• 手动修复：添加 "args": ["--no-sandbox", "--disable-dev-shm-usage", "--disable-gpu"]

❌ 未找到“claude mcp add json”命令

• 解决方案：确保安装了Claude Code CLI
• 替代：使用上述手动配置方法

❌ Windows中的路径错误

• 解决方案：使用双反睫毛 \\ Windows路径的JSON字符串
• 示例: "C:\\\\Users\\\\name\\\\project\\\\venv\\\\Scripts\\\\python.exe"

✨ 为什么开发人员会这样做

• 在阻止传统自动化的受保护站点上工作
• 通过Chrome DevTools协议进行像素精确的元素克隆
• 通过AI聊天进行全面的网络调试——查看每个请求、响应、标头和有效载荷
• 你的AI代理变成了一个网络侦探——不再猜测调用了哪些API
• 🎛️ 模块化架构——禁用未使用的部分，运行最少的安装
• ⚡ 轻量级部署——从22个核心工具到完整的89个工具库
• 清洁的MCP集成——不需要自定义代理或包装器
• 90个重点工具，分为11个逻辑部分

建立在 nodrive +Chrome DevTools协议+FastMCP

🎯 新增：高级文本输入

最新增强功能（v0.2.3）：革命性的文本输入功能，解决了常见的自动化挑战：

⚡ 即时粘贴文本

# NEW: paste_text() - Lightning-fast text input via CDP
await paste_text(instance_id, "textarea", large_markdown_content, clear_first=True)

• 快10倍 比逐个字符打字
• 使用Chrome DevTools协议 insert_text 为了获得最大的兼容性
• 非常适合大型内容（README文件、代码块、表单）

📝 智能新线处理

# ENHANCED: type_text() with newline parsing
await type_text(instance_id, "textarea", "Line 1\nLine 2\nLine 3", parse_newlines=True, delay_ms=10)

• parse_newlines=True：转换 \n 实际按下Enter键
• 多行表单、聊天应用程序和文本编辑器必备
• 以可定制的速度保持类人打字

🔧 为什么这很重要

• 表单自动化：正确处理复杂的多行输入
• 内容管理：立即粘贴大型文档而不会超时
• 聊天应用程序：发送带有适当换行符的多行消息
• 代码输入：粘贴保留格式的代码段
• Markdown编辑器：用适当的行距处理内容

现实世界的影响：过去需要30多秒的字符输入，现在可以立即完成，对复杂的表单进行适当的换行处理。

🛡️ 新增：跨平台兼容性和根支持

最新增强功能（v0.2.4）：自动平台检测和权限处理，消除了常见的浏览器生成问题：

⚙️ 智能环境检测

# NEW: Automatic privilege detection and sandbox handling
validate_browser_environment_tool()  # Diagnose your environment

• 根/管理员检测：自动添加 --no-sandbox 以root身份运行时
• 集装箱检测：检测Docker/Kubernetes并添加特定于容器的参数
• 平台感知：自动处理Windows、Linux、macOS差异
• Chrome探索：自动查找Chrome/Chromium安装

🔧 灵活的Args处理

// All these formats now work:
{"args": ["--disable-web-security"]}                    // JSON array
{"args": "[\"--disable-web-security\"]"}              // JSON string  
{"args": "--disable-web-security"}                     // Single string

• 支持多种格式：接受JSON数组、JSON字符串或单个字符串
• 智能解析：先尝试JSON，然后优雅地回退
• 向后兼容：现有配置继续工作

📊 内装式诊断器

# NEW: Environment validation tool
validate_browser_environment_tool()
# Returns: platform info, Chrome path, issues, warnings, recommendations

• 飞行前检查：在浏览器启动之前验证环境
• 问题检测：识别常见问题并提供解决方案
• 平台洞察：调试的详细系统信息

🎯 为什么这很重要

• 根用户支持：Linux服务器上不再有“连接浏览器失败”
• 容器兼容性：适用于Docker、Kubernetes和无服务器环境
• Windows管理员：处理UAC和权限升级情况
• 错误预防：在问题导致失败之前抓住问题
• 更好的调试：清除故障诊断

现实世界的影响：浏览器生成现在可以在所有环境中可靠地工作——从本地开发到生产容器再到CI/CD管道。

🎛️ 模块化架构

v0.2.2中的新功能：Stealth Browser MCP现在支持模块化工具加载！准确选择您需要的功能：

⚙️ 安装模式

📦 工具部分

# List all sections with tool counts
python src/server.py --list-sections

# Examples:
python src/server.py --minimal                    # Only browser + element interaction
python src/server.py --disable-cdp-functions      # Disable Chrome DevTools functions  
python src/server.py --disable-dynamic-hooks      # Disable AI network hooks
python src/server.py --disable-debugging          # Disable debug tools

优点：

• 🚀 更快的启动 -只装载您需要的工具
• 💾 更小的内存占用 -减少资源使用
• 🏗️ 更干净的界面 -减少AI聊天中的工具混乱
• ⚙️ 特定环境 -dev/prod的不同配置

🆚 隐形vs剧作家MCP

用户关心的网站：领英•Instagram•推特/X•亚马逊•银行•政府门户网站•Cloudflare API•耐克SNKRS•Ticketmaster•Supreme

工具箱

🎨 特色演示：增强代码英雄克隆

🎯 真实对话： 用户要求克劳德克隆增强代码英雄部分。事情是这样的：

用户提示：

“嘿，创建一个浏览器，克隆网站的英雄https://www.augmentcode.com/"

克劳德自动做了什么：

1. 无法检测到的垃圾邮件浏览器 例子
2. 导航 到 augmentcode.com
3. 已识别英雄部分 使用DOM分析
4. 提取完整元素 包含所有样式、结构和资产
5. 生成像素完美的HTML再现 使用内联CSS
6. 增强 动画和响应式设计会更好

结果：

✅ 完美的像素精确娱乐 整个英雄部分
✅ 专业动画 和悬停效果
✅ 完全响应式设计 跨所有设备
✅ 功能齐全 包括导航和CTA按钮
✅ 所有这些都是通过简单的AI聊天完成的 -无需手动编码

整个过程只花了不到2分钟的人工智能对话！

演示的主要功能：

• 🎨 CDP精确元素提取 -完美获取每个CSS属性
• 🎬 高级UI娱乐 -构建可用于生产的HTML/CSS
• 📱 响应式增强 -自动添加移动优化
• ✨ 动画增强 -通过平滑过渡改进原始效果
• 🚀 一个指挥自动化 -通过简单聊天执行复杂任务

💡 这展示了隐形浏览器MCP的真正力量——将复杂的网络克隆任务转化为简单的人工智能对话。

🧪 真实世界的例子

• 市场调研：从5个竞争对手那里提取定价/特征，并进行比较
• UI/UX克隆：用精确的字体、样式和交互重新创建定价部分
• 库存监控：查看产品页面并在有库存时发出警报
• 逆向工程：拦截请求、映射端点和理解数据流

您可以从单个AI代理聊天中驱动上述所有内容。

🛣️ Roadmap

请参阅中的实时计划 ROADMAP.md.欢迎捐款。

贡献

我们喜欢第一次捐款。阅读 贡献.md 并打开一个PR。

如果这个项目节省了你的时间，可以考虑主演这个仓库并与朋友分享。

💼 需要网站或应用程序开发吗？尝试DevHive工作室

DevHive工作室 是一个公平的市场，将企业与熟练的开发人员联系起来。与其他平台不同，我们把开发人员放在首位，同时让客户负担得起成本。

🏆 为什么选择DevHive？

• 对于开发者：保留客户支付金额的60%（+按时交货奖金）
• 对于客户：高质量的网站/应用程序起价仅50美元
• 给每个人：透明定价、快速交货、专家团队

🛠️ 可用服务

Web开发•移动应用程序•机器人和自动化•电子商务•UI/UX设计•安全•定制软件•以及更多

准备好开始你的项目了吗？ 立即联系DevHive工作室：

• 🌐 devhivestudios.com
• 💬 联系Discord

DevHive工作室——公平的市场。质量结果。

☕ 支持这个项目

如果此浏览器自动化MCP为您节省了时间或赚了钱，请考虑支持开发：

• ☕ 给我买杯咖啡: buymeacoffee.com/vibheksoni
• ₿ 比特币: 3QaS5hq2416Gd3386M6c9g5Dgc5RgvP3o2
• Ł莱特币: MM35KN1wUXREpwjj2RsmiKHM1ZWKDmeqDz
• ◎ 索拉纳: 3LkBXDKLZXAgCRzAApa6dQG3ba7zRkUK82Bvmd9JWMdi

每一份贡献都有助于维护和改进这个项目！ 🚀

📄 许可证

麻省理工学院——见 许可证.

如果你想让你的AI代理访问任何网站，请在这个仓库上加星。它比你想象的更有帮助。

⭐ 明星历史