stealth-browser-mcp 98 个工具完整清单:11 大模块按需加载,告别 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
stealth-browser-mcp是一个面向 AI Agent 的浏览器自动化 MCP 服务器:基于 Chrome DevTools Protocol(CDP)实现不可检测的浏览器操作,覆盖网页导航、网络钩子、DOM 提取和像素级 UI 克隆。它内置98 个 MCP 工具,分布在11 个功能模块中——本清单帮你 3 分钟选对模块,告别工具选择困难 🎯
为什么需要这份工具清单?
把 98 个工具一次性全部暴露给 AI,会带来两个问题:
- 上下文爆炸:工具描述挤占 Token 预算,AI 反而更容易选错工具
- 噪音干扰:只爬网页的人根本用不到"元素克隆""网络钩子"等重型工具
stealth-browser-mcp 的解法很直接:按模块(section)加载工具。src/server.py 通过@section_tool("模块名")装饰器把每个工具归属到对应模块,启动时用开关决定哪些模块上线。
一键查看 11 大模块:按需加载的 3 个开关
无需读代码,两条命令就能规划你的工具集:
--list-sections:打印全部 11 个模块及每个模块的工具数量--disable-<模块名>:只关闭你不需要的模块(如--disable-cdp-functions)--minimal:极简模式,只保留浏览器管理 + 元素交互两大核心模块(21 个工具),最适合纯爬虫/网页操作场景
例如只做网页截图时,关闭克隆、网络钩子等模块后,AI 的工具列表立刻清爽,选择准确率显著提升。
11 大模块速览
| 模块 | 工具数 | 定位 | 核心源码 |
|---|---|---|---|
| browser-management | 8 | 实例生命周期与导航 | src/browser_manager.py |
| element-interaction | 13 | 点击、输入、滚动、截图 | src/dom_handler.py |
| tabs | 5 | 多标签页管理 | src/server.py |
| network-debugging | 10 | 请求/响应抓包与过滤 | src/network_interceptor.py |
| cookies-storage | 3 | Cookie 读写清除 | src/server.py |
| cdp-functions | 14 | CDP 底层函数执行 | src/cdp_function_executor.py |
| element-extraction | 9 | 样式/结构/事件提取 | src/element_cloner.py |
| progressive-cloning | 10 | 分层渐进克隆 | src/progressive_element_cloner.py |
| file-extraction | 9 | 提取结果落盘 | src/file_based_element_cloner.py |
| dynamic-hooks | 10 | AI 自学习网络钩子 | src/dynamic_hook_system.py |
| debugging | 7 | 调试视图与热重载 | src/debug_logger.py |
98 个工具完整清单(按模块)
1️⃣ 浏览器管理 browser-management(8 个)
| 工具 | 作用 |
|---|---|
spawn_browser | 启动隐身浏览器实例(支持无头、代理、视口、时区、资源屏蔽) |
list_instances | 列出所有活跃实例 |
close_instance | 关闭指定实例 |
get_instance_state | 查看实例详细状态 |
navigate | 导航到指定 URL |
go_back/go_forward | 前进 / 后退 |
reload_page | 重新加载页面 |
2️⃣ 元素交互 element-interaction(13 个)
| 工具 | 作用 |
|---|---|
query_elements | 按选择器查询元素 |
click_element | 点击元素 |
type_text/paste_text | 输入 / 粘贴文本 |
press_key | 模拟按键 |
file_upload | 上传文件 |
select_option | 选择下拉项 |
get_element_state | 查询元素可见性、文本等状态 |
wait_for_element | 等待元素出现 |
scroll_page | 滚动页面 |
execute_script | 执行自定义 JS |
get_page_content | 获取页面内容 |
take_screenshot | 页面截图 |
3️⃣ 标签页 tabs(5 个)
list_tabs列出标签页、switch_tab切换、close_tab关闭、get_active_tab查看当前标签、new_tab新建标签。
4️⃣ 网络调试 network-debugging(10 个)
| 工具 | 作用 |
|---|---|
list_network_requests | 列出抓到的全部请求 |
get_request_details/get_response_details | 查看请求 / 响应详情 |
get_response_content | 获取响应体内容 |
search_network_requests | 按条件搜索请求 |
set_network_capture_filters/get_network_capture_filters | 设置 / 查看抓包过滤器 |
export_network_data/import_network_data | 导出 / 导入抓包数据 |
modify_headers | 修改请求头 |
5️⃣ Cookie 与存储 cookies-storage(3 个)
get_cookies读取、set_cookie写入、clear_cookies清除——登录态保持与多账号场景的最小工具集。
6️⃣ CDP 函数执行 cdp-functions(14 个)
模块中工具最多的一组,直接驱动 CDP Runtime:
list_cdp_commands列出可用命令、execute_cdp_command执行 CDP 命令、get_execution_contexts获取 JS 执行上下文、discover_global_functions/discover_object_methods发现页面函数与方法、inspect_function_signature检查函数签名、call_javascript_function调用页面函数、inject_and_execute_script注入并执行脚本、add_script_to_evaluate_on_new_document为新文档注入脚本、create_persistent_function/execute_function_sequence创建持久函数与序列执行、create_python_binding/execute_python_in_browser甚至在浏览器里跑 Python、get_function_executor_info查看执行器状态。
7️⃣ 元素提取 element-extraction(9 个)
提取网页元素的"五大件"——样式、DOM 结构、事件绑定、动画、引用资源:
| 工具 | 作用 |
|---|---|
extract_element_styles | 提取元素完整样式 |
extract_element_structure | 提取 DOM 结构 |
extract_element_events | 提取事件绑定 |
extract_element_animations | 提取动画数据 |
extract_element_assets | 提取引用资源(图片/字体) |
extract_element_styles_cdp | 走 CDP 通道提取样式 |
extract_related_files | 提取相关文件 |
clone_element_complete/extract_complete_element_cdp | 一键完整克隆 / 完整提取 |
配套 JS 提取脚本见 src/js/ 目录(如 extract_styles.js)。
8️⃣ 渐进克隆 progressive-cloning(10 个)
大元素直接克隆容易超时?渐进克隆把任务拆成可暂停的"扩展步骤",先克隆骨架,再按需expand_styles(样式)、expand_events(事件)、expand_children(子元素)、expand_css_rules(CSS 规则)、expand_pseudo_elements(伪元素)、expand_animations(动画与字体)逐层展开;list_stored_elements查看已存储元素,clear_stored_element/clear_all_elements清理缓存。
9️⃣ 文件提取 file-extraction(9 个)
把提取结果直接写入磁盘,方便后续交给其他程序:clone_element_to_file克隆落盘、extract_complete_element_to_file完整提取落盘,以及extract_element_styles_to_file、extract_element_structure_to_file、extract_element_events_to_file、extract_element_animations_to_file、extract_element_assets_to_file五类单项落盘;list_clone_files列出克隆文件,cleanup_clone_files清理旧文件。
🔟 动态钩子 dynamic-hooks(10 个)
这是最有意思的模块:让 AI自己写钩子函数去拦截网络行为,并且内置了"AI 自学习"接口——get_hook_documentation开发文档、get_hook_examples示例函数、get_hook_requirements_documentation需求说明、get_hook_common_patterns常见模式,AI 可以先"学习"再动手;validate_hook_function在创建前校验代码。管理侧提供create_dynamic_hook/create_simple_dynamic_hook创建、list_dynamic_hooks列表、get_dynamic_hook_details详情、remove_dynamic_hook移除。钩子学习机制实现在 src/hook_learning_system.py。
1️⃣1️⃣ 调试与系统 debugging(7 个)
get_debug_view查看调试视图、clear_debug_view清空日志、export_debug_logs导出日志、get_debug_lock_status检查日志锁状态、hot_reload不重启服务器热重载模块(开发 MCP 工具时必备)、reload_status查看模块状态、validate_browser_environment_tool体检浏览器环境。
三种典型场景:各开哪些模块?
| 场景 | 建议加载模块 |
|---|---|
| 纯爬虫 / 截图 | --minimal(浏览器管理 + 元素交互 + 标签页) |
| 克隆网页某个 UI 区块 | + element-extraction + progressive-cloning + file-extraction |
| 接口分析 / 网络拦截 | + network-debugging + dynamic-hooks + cdp-functions |
下面这张图就是 element-extraction 模块的实战成果:AI 从目标网站提取了头部区块的样式、结构、资源,还原出像素级一致的 Hero 区块(demo/augment-hero-recreation.html):
小结
- 用
--list-sections看全貌,--minimal起步,再按任务--disable-*增删 - 98 个工具 = 11 个模块,每个模块对应清晰源码文件(见上方速览表)
- 记住三个高频组合:爬网页用前两个模块、克隆 UI加克隆三件套、抓接口加网络与钩子模块
工具选得准,AI 干活才不慌。把这份清单收藏起来,下次配置 MCP 服务器时直接对号入座 ✅
【免费下载链接】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),仅供参考