BAIZE AI RESOURCE

面向 MCP 客户端的隐身浏览器自动化服务器,基于 nodriver 与 CDP 提供 97 个工具。

stealth-browser-mcp

面向 MCP 客户端的隐身浏览器自动化服务器,基于 nodriver 与 CDP 提供 97 个工具。

stealth-browser-mcp

资源介绍

Stealth Browser MCP 是一个 MCP 服务器,把真实 Chrome、Chromium 或 Edge 浏览器实例封装成 AI Agent 可调用的工具集。它基于 nodriver 与 Chrome DevTools Protocol 控制浏览器,并通过 FastMCP 暴露标准 MCP 接口,因此 Claude Code、Claude Desktop 等 MCP 客户端可以直接用自然语言驱动浏览器。

项目提供 97 个工具,覆盖浏览器管理、元素交互、元素提取、文件提取、网络调试、CDP 函数执行、渐进式克隆、Cookie/存储、标签页、调试与动态 Hook 等 11 个分区,并支持 --minimal 模式只加载约 20 个核心工具。它强调反自动化检测能力,在测试中通过过 Cloudflare 与 Queue-It 类挑战;同时支持像素级元素克隆、网络请求拦截、受限 Python Hook 改写请求/响应,以及跨 Windows、macOS、Linux 与 Docker 运行。

它适合需要让 AI Agent 访问受保护站点、抓取页面结构、复刻 UI 组件或调试前端网络请求的开发者与自动化团队。

MCP 能力

反自动化检测

基于 nodriver 驱动真实 Chrome 系浏览器,在测试中通过过 Cloudflare 与 Queue-It 类挑战,结果随站点、地区、浏览器版本和检测器版本变化。

97 个工具、11 个分区

覆盖浏览器管理、元素交互、元素提取、文件提取、网络调试、CDP 函数、渐进式克隆、Cookie/存储、标签页、调试与动态 Hook,可用 --minimal 只加载核心工具。

像素级元素克隆

通过 CDP 提取元素的 CSS、DOM 结构、事件、动画与资源,用于复刻页面组件或分析 UI 实现。

网络检查与动态 Hook

可查看请求、响应、头部、载荷与响应体,并用受限 Python Hook 拦截、阻断、重定向、填充或修改请求/响应流。

CDP 与预文档脚本

支持执行 JavaScript、直接发送 CDP 命令,以及通过 add_script_to_evaluate_on_new_document 在页面解析前注入脚本,用于 WebGL/navigator 等反检测伪装。

跨平台与多浏览器

在 Windows、macOS、Linux、Docker 与 CI 环境中运行,自动检测操作系统并发现 Chrome、Chromium 和 Microsoft Edge 的可执行文件,使 AI 代理无需手动配置浏览器路径即可启动真实浏览器实例。

资源配置

支持客户端

Claude CodeClaude Desktop其他 MCP Client

安装方式

PipDocker源码安装

配置方式

JSON配置环境变量命令行

运行环境

PythonDocker本地系统

安装与配置

  1. 准备 Python 环境与本机 Chrome 系浏览器,安装 Stealth Browser MCP 及其浏览器依赖。

  2. 在 Claude、Cursor 等 MCP 客户端中添加服务器启动配置并完成连接。

  3. 向 Agent 提供允许访问的页面和具体任务,例如导航、读取页面、元素操作或网络调试。

  4. 先在测试环境验证脚本,遵守网站条款与访问限制,不将隐身能力用于绕过授权或安全控制。

使用案例

复刻页面 Hero 区域

使用场景需要把某个网站的 Hero 区块还原成可用的 HTML/CSS。

让 AI 启动浏览器并访问目标站点,通过元素提取工具抓取 CSS 属性、DOM 结构与动画,生成生产级 HTML 代码。

访问受反爬保护的站点

使用场景目标站点使用 Cloudflare 等反自动化检测,普通工具被拦截。

使用 stealth-browser-mcp 启动真实 Chrome 实例并导航,在测试中可绕过 Cloudflare 与 Queue-It 类挑战后继续抓取或操作页面。

调试 SPA 网络请求

使用场景需要分析单页应用发出的 API 调用与响应内容。

导航开始后使用 list_network_requests、search_network_requests、get_request_details、get_response_details 和 get_response_content 查看请求与响应体。

注入反检测脚本

使用场景站点在首次内联脚本执行时就检查 WebGL 渲染器或 navigator 属性。

在导航前调用 add_script_to_evaluate_on_new_document,保持 world_name=None 并设置 run_immediately=True,在页面解析阶段修改浏览器 API。

包含内容

stealth-browser-mcp-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt