☰
5分钟快速上手 stealth-browser-mcp:从零接入 Claude 发出第一条浏览器自动化指令
2026/10/7 20:36:04 网站建设 项目流程

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 的前置条件

开始前,确认你的机器满足两个硬性条件 ✅:

条件要求
Python3.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.txt

Windows 用户只需将激活命令替换为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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询