Stealth Browser MCP

Stealth Browser MCP 是适配MCP协议AI代理的隐蔽浏览器自动化服务，底层基于nodriver、Chrome DevTools Protocol（CDP）与FastMCP，启动真实Chrome/Chromium/Edge实例，用来突破Cloudflare、Queue‑It等反机器人验证与登录墙，让AI代理直接操控浏览器完成网页任务。

核心功能

• 反爬虫对抗：可绕过Cloudflare、Queue-It人机挑战（效果受站点、地区、浏览器版本影响）
• 模块化工具集：全套共101个工具，最小精简模式仅保留21个核心工具，可按需关闭不需要模块
• 像素级元素克隆：通过CDP提取DOM、CSS、事件、动画、资源等完整页面元素
• 网络抓包与拦截：查看请求头、载荷、响应正文；动态Python钩子可拦截、修改、转发网络流量
• CDP原生能力：页面内执行JS、运行CDP命令、前置脚本注入；支持模拟真人输入、大文本粘贴
• 跨平台：Windows、macOS、Linux、Docker、CI流水线，自动识别系统与浏览器路径

快速部署要求

环境依赖 Python3.10+，本地安装Chrome/Chromium/Microsoft Edge。

1. 克隆仓库，创建Python虚拟环境并安装依赖

git clone https://github.com/vibheksoni/stealth-browser-mcp.git
cd stealth-browser-mcp
python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
pip install -r requirements.txt

2. 接入MCP客户端，支持 Claude Code CLI、Claude Desktop、Cursor，通过stdio或HTTP方式配置服务。
3. 仓库内置配套Agent技能文件，指导AI代理遵循正确操作顺序、状态校验、浏览器清理逻辑，解决代理选错工具、忘记校验页面状态的问题。

多种运行模式

• 默认完整模式：101个工具，全量浏览器自动化、调试能力
• –minimal最小模式：21个核心工具，轻量化网页交互
• –xpool-safe：84个工具，禁用高风险CDP Runtime相关能力
• 支持单独禁用各类模块：网络钩子、CDP函数等

安全说明

该MCP服务权限很高，可执行页面JS、读取Cookie、拦截网络、上传本地文件。推荐本地stdio模式，在可信桌面MCP客户端内使用；若启用HTTP远程访问，务必配置鉴权token，禁止公网裸奔暴露。