5分钟快速上手 stealth-browser-mcp:从零接入 Claude 发出第一条浏览器自动化指令
【免费下载链接】stealth-browser-mcpStealth browser automation for AI agents over MCP and the Chrome DevTools Protocol: navigation, network hooks, DOM extraction, and pixel-accurate UI cloning.项目地址: https://gitcode.com/gh_mirrors/ste/stealth-browser-mcp
stealth-browser-mcp 是一个面向 AI 智能体的隐身浏览器自动化 MCP 服务器:它基于 nodriver、Chrome DevTools Protocol(CDP)和 FastMCP,让 Claude 等 AI 客户端能驱动真实的 Chrome 系浏览器,完成页面导航、网络拦截、DOM 提取和像素级 UI 克隆,内置 11 个分区共 98 个自动化工具。本文带你从零开始,5 分钟内把它接入 Claude,发出第一条浏览器自动化指令。
30秒认识 stealth-browser-mcp:它能做什么
在动手之前,先了解这个 MCP 服务器的核心能力 🧭:
- 反机器人检测:在真实 Chrome 系浏览器实例上运行,已实测通过 Cloudflare、Queue-It 风格的人机校验;
- 98 个工具、11 个分区:从基础导航到 CDP 函数执行全覆盖,支持按需裁剪到 21 个工具的核心模式;
- 像素级元素克隆:通过 CDP 提取完整元素的 CSS、DOM 结构、事件、动画与资源;
- 网络检查:在 AI 对话中直接查看请求、响应、头部和数据包;
- 动态钩子系统:用受限 Python 钩子拦截、阻断、重定向或修改请求/响应。
下面的演示展示了通过 AI 聊天指令驱动浏览器完成挑战页通过的完整过程:
环境准备:安装 stealth-browser-mcp 的前置条件
开始前,确认你的机器满足两个硬性条件 ✅:
| 条件 | 要求 |
|---|---|
| Python | 3.10 或更高版本(见 pyproject.toml) |
| 浏览器 | Chrome、Chromium 或 Microsoft Edge(服务器会自动探测可用的浏览器可执行文件) |
依赖清单非常精简,全部列在 requirements.txt 中,核心是fastmcp(MCP 框架)和nodriver(隐身浏览器驱动),无需额外配置浏览器指纹。
一键安装步骤:克隆并安装依赖
打开终端,依次执行以下命令(macOS / Linux):
git clone https://gitcode.com/gh_mirrors/ste/stealth-browser-mcp cd stealth-browser-mcp python -m venv venv source venv/bin/activate pip install -r requirements.txtWindows 用户只需将激活命令替换为venv\Scripts\activate。
💡 服务器入口是 src/server.py,它基于 FastMCP 注册了全部 98 个工具。支持
--minimal(21 个核心工具)、--list-sections(查看分区)、--debug(输出详细诊断日志)等参数。
最快配置方法:把 stealth-browser-mcp 接入 Claude
安装完成后,把 MCP 服务器注册给 Claude Code CLI(推荐方式)。macOS / Linux:
claude mcp add-json stealth-browser-mcp '{ "type": "stdio", "command": "/path/to/stealth-browser-mcp/venv/bin/python", "args": ["C:/path/to/stealth-browser-mcp/src/server.py".replace("C:","/")] }'请直接把两条路径替换为你本地的真实克隆路径和虚拟环境 Python 路径。Windows(PowerShell):
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\"]}"如果你使用的是 Claude Desktop 或 Cursor,则在配置文件(mcpServers字段)中写入相同的command+args即可,结构完全一致。
📌 仓库还内置了 Agent 技能 skills/stealth-browser-mcp/agents/openai.yaml,会教会 AI 客户端推荐的工具调用顺序、状态检查与浏览器清理规则。如果你的客户端支持 Codex 风格技能,将
skills/stealth-browser-mcp目录链接到技能目录即可。
发出第一条浏览器自动化指令
重启 Claude 客户端,然后在对话中直接说:
Use stealth-browser to navigate to https://example.com and take a screenshot.
几秒后,Claude 就会自动完成:spawn_browser()启动隐身浏览器 →navigate()打开页面 →take_screenshot()截图回传。🎉 至此,你的第一条浏览器自动化指令就跑通了!
跑通之后,试试这些进阶玩法(更多现成提示词见 examples/claude_prompts.md):
- 内容提取:「导航到某网站,用
extract_complete_element_cdp提取主内容区的 HTML 结构」; - API 抓包:「在我操作页面的同时,用
list_network_requests监控所有 API 调用,并为每个请求展示头部和数据流」; - 竞品分析:「打开 5 个竞品网站的标签页,抓取各自的定价区块并生成对比表」。
常见问题快速排查
遇到小问题时,对照官方 Troubleshooting 思路处理 🔧:
| 症状 | 解决办法 |
|---|---|
| 提示找不到兼容浏览器 | 安装 Chrome/Chromium/Edge,或用validate_browser_environment_tool()诊断 |
| 工具卡住或返回乱码 JSON | 确保 stdio 模式下没有调试输出打到 stdout;保持 debug 日志默认关闭 |
| Linux/Docker 中浏览器崩溃 | 仅在必要时加--sandbox=false,服务器会自动识别容器环境调整参数 |
| 98 个工具太多刷屏 | 用python src/server.py --minimal只加载 21 个核心工具 |
浏览器闲置 10 分钟(BROWSER_IDLE_TIMEOUT默认 600 秒)后会自动回收,启动时还会清理遗留的uc_*临时配置,无需担心僵尸进程。
下一步:从导航到深度自动化
接入成功后,你可以继续探索:用网络检查工具反向分析网站 API、用动态钩子实时改写请求、用渐进式克隆按需展开元素的样式、事件与子节点。所有能力都在这一个 MCP 对话里,按需组合即可。
祝你的 AI 智能体早日「冲浪」自由 🌊!
【免费下载链接】stealth-browser-mcpStealth browser automation for AI agents over MCP and the Chrome DevTools Protocol: navigation, network hooks, DOM extraction, and pixel-accurate UI cloning.项目地址: https://gitcode.com/gh_mirrors/ste/stealth-browser-mcp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考