stealth-browser-mcp
vibheksoni/stealth-browser-mcp加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象这样一个场景:凌晨两点,你终于写好了爬虫脚本,兴冲冲地跑起来——结果第一页就弹出 Cloudflare 验证框。"验证你是人类"——一个永远跨不过去的坎。
这是所有做网页自动化、爬虫、数据采集的开发者最熟悉的噩梦。传统工具如 Playwright、Selenium,虽然能控制浏览器,但它们的行为太"机器"了:没有真正的浏览器指纹、会触发 JavaScript 挑战、被检测为 bot 流量。
Stealth Browser MCP 正是为解决这个痛点而生的。它是唯一能绕过 Cloudflare 等反爬系统的浏览器自动化 MCP 服务器,让 AI Agent 能够真正"像人一样"浏览网页。
这个项目的技术选型非常有意思。作者选择了三条腿走路:
nodriver 是核心——这是一个基于 Chrome DevTools Protocol(CDP)的无头浏览器库,相比 Playwright 更底层,能够更精细地控制浏览器行为。nodriver 专门针对反爬场景做了优化,使用真实的 Chrome 浏览器实例而非模拟环境。
FastMCP 是连接层——将浏览器控制能力封装成 MCP(Model Context Protocol)工具,供 Claude、GPT 等 AI Agent 通过自然语言调用。Agent 不需要写代码,只需说"帮我打开这个页面并截图"。
Dynamic Hook System 是亮点——AI 可以动态注入 JavaScript 网络钩子,拦截/修改 API 请求,实现"AI 控制网络流量"。这在需要绕过某些反爬机制时特别有用。

根据官方数据,在 Cloudflare 保护的站点上,Stealth Browser MCP 达到了 98.7% 的成功率。这意味着什么?

场景 1:AI 数据采集 Agent
想让 AI 自动采集某电商平台的价格数据,但该平台有 Cloudflare 保护?传统方法需要买代理池、换 IP、识别验证码,现在只需一个 MCP 调用。
场景 2:自动化测试
测试你的网站在 Cloudflare 保护下的真实用户体验?可以用 Stealth Browser MCP 模拟真实用户行为,测试登录、表单提交等流程。
场景 3:社交媒体自动化
Twitter、Instagram 等平台对自动化行为检测严格。Stealth Browser MCP 可以让 AI 以真实用户身份操作,降低被封号风险。
场景 4:金融数据获取
银行、证券等金融网站通常有复杂的反爬机制。该工具可以帮 AI Agent 获取公开的金融数据。
| 能力 | Stealth Browser MCP | Playwright MCP |
|---|---|---|
| Cloudflare 绕过 | ✅ 专门优化 | ❌ 通常失败 |
| 验证码处理 | 自动绕过 | 需手动处理 |
| 浏览器指纹 | 真实 Chrome | 容易被检测 |
| 网络拦截 | ✅ 支持动态 Hook | 有限 |
| 部署难度 | 需配置 Chrome | 更简单 |
| 学习曲线 | 中等 | 低 |
简言之:如果目标网站没有反爬保护,Playwright MCP 更简单;如果需要穿越 Cloudflare,Stealth Browser MCP 是目前社区最推荐的方案。
# 1. 安装依赖
pip install stealth-browser-mcp
# 2. 添加到 Claude Code skills
git clone https://github.com/vibheksoni/stealth-browser-mcp ~/.claude/skills/stealth-browser-mcp
# 3. 配置 MCP(Claude Code 配置文件中添加)
{
"mcpServers": {
"stealth-browser": {
"command": "fastmcp",
"args": ["run", "src/server.py"]
}
}
}
# 4. 重启 Claude Code,开始使用
# > 用 stealth browser 打开 example.com 并截图
Docker 部署同样简单:
docker build -t stealth-browser-mcp .
docker run -p 8000:8000 stealth-browser-mcp

不适用于:需要执行复杂 JavaScript 交互(如地图应用)、WebGL 密集型应用、依赖浏览器扩展的场景。
合规性提醒:使用该工具时请遵守目标网站的 robots.txt 和服务条款,仅用于合法的数据采集和自动化任务。作者在 SECURITY.md 中也明确列出了道德使用准则。
赞助商:项目获得 NodeMaven 和 RapidProxy 两个代理服务商赞助,README 中有推荐代码(STEALTHMCP35 可享 35% 折扣)。这是商业赞助,不影响项目本身的免费开源属性。
在 AI Agent 快速发展的当下,浏览器控制能力变得越来越重要。传统的网页浏览对人类来说是本能,对 AI 却是巨大的技术门槛。Stealth Browser MCP 填补了这个空白,让 AI Agent 能够真正"看到"并"操作"互联网上的任何内容。
项目自 2025 年 8 月上线以来,GitHub Stars 从 0 增长到 2100+,在 Glama.ai 的浏览器自动化 MCP 服务器评测中排名靠前,被描述为"社区最爱的 Cloudflare 绕过方案"。这说明市场对这类工具的需求是真实且旺盛的。