AI-Browser-MCP · Windows 浏览器自动化 MCP 服务

任意 AI 代理 · 一句话操控真实浏览器 · Cursor / Claude / Cline

268 工具 · MCP 协议 · 原生 API 优先 · FBrowser CEF · 127.0.0.1:9222 · MIT

Download v2.8.0 License: MIT Release MCP Platform FBrowser

3 步上手 · 场景演示 · 对比 Playwright · 下载 · 开源公告 · English


✨ 一句话介绍

下载 AI-Browser-MCP-x64-v2.8.0.zip(~157MB),解压运行 AI-Fbowser-Mcp.exe。在 Cursor / Claude 里说句话,268 个预封装工具自动执行:采集数据、逆向 POST 加密、CDP 定位签名算法、自动填表。

接入方式 适用
stdio MCP Cursor、Claude Desktop、Cline — 配置 mcp_bridge.js
HTTP POST 任意语言 / 自研 Agent — POST http://127.0.0.1:9222/mcp
WebSocket 长连接 JSON-RPC — ws://127.0.0.1:9222

⚡ 3 步上手

1. 下载 x64(~157MB)或 win32(~136MB)→ 解压 → 双击 AI-Fbowser-Mcp.exe

2. 确认 http://127.0.0.1:9222/health"status":"ok"

3. Cursor 配置(.cursor/mcp.json):

{
  "mcpServers": {
    "ai-browser": {
      "command": "node",
      "args": ["mcp_bridge.js"]
    }
  }
}

自检:node mcp_bridge.js --check。然后对 AI 说:「打开百度搜索今日新闻」

其他 Agent:任意 MCP 客户端指向 http://127.0.0.1:9222/mcp HTTP 或 ws://127.0.0.1:9222 WebSocket。


🎯 典型场景

不用写脚本。在 AI 代理里用自然语言描述目标即可。

# 场景 一句话 自动调用的工具
数据采集 「滚动商品列表,采标题价格 JSON」 navigateevaluatedom_query / collect
逆向 POST 「扫描 XHR/fetch,标出疑似加密字段」 reverse_prepareinject Hook → network
定位算法 「提交时下断点,跟到 sign 函数给源码」 debugger_enableset_breakpointstack
自动填表 「登录后台,导出订单前20行」 fill_*clickcollect
固化复用 「存成 workflow,下次一键跑」 workflow_run
帮我把 https://example.com/products 前 3 页的商品标题和价格采集成 JSON。

打开 https://www.douyin.com ,找出 POST 请求里疑似加密的字段并说明依据。

在这个登录页提交时下断点,定位计算 password/sign 的 JS 函数,把函数名和源码给我。

用账号 test / 密码 123456 登录后台,进入「订单列表」,把前 20 行导出成表格。

把「打开某站 → 登录 → 翻 3 页采集 → 汇总 JSON」写成 workflow JSON 并跑一遍验证。

执行流程(AI 自动编排):

你说一句话 → Agent 选工具链 → sync-wait 逐步等结果 → 整理返回
若某步失败(success:false)→ Agent 自动换策略或报告原因

Douyin POST 逆向扫描演示


🆚 VS Playwright / Puppeteer

维度 自建 Playwright / Puppeteer AI-Browser-MCP
上手 写脚本、装驱动、调试选择器 下载 zip → 运行 exe → AI 一句话
AI 集成 Agent 现写代码,易出错 268 个预封装 MCP 工具,Agent 直接调用
浏览器 常无头 / 需额外配置 FBrowser CEF 真实窗口,行为接近用户
逆向 / 断点 需自己 Hook + DevTools 内置 browser_injectCDP 调试器、场景脚本
隐私 视部署方式 默认 127.0.0.1 本机,数据不出机器
平台 跨平台 Windows x64 + win32 专精
许可 视项目 MIT · 完整源码公开

🔌 核心能力(268 工具 · 22 分类)

分类 工具数 能力
导航与页面 11 navigate reload back forward get_url get_title
DOM 查询 8 dom_query dom_click dom_get_html dom_inner_html
DOM 填表 13 fill_click fill_set_value fill_select fill_exists
JS 执行 5 evaluate execute_js console_eval inject
等待与状态 4 wait is_loading loading_info status
网络抓包 6 network network_export network_body intercept
数据提取 2 scrape extract
截图与打印 3 screenshot print print_to_pdf
Cookie / 代理 9 get_cookies set_cookie delete_cookies set_proxy
鼠标键盘 7 mouse_click mouse_move key_event touch_*
窗口管理 5 create close move_window resize
CDP 协议 3 cdp cdp_call cdp_event
调试器 13 debugger_enable set_breakpoint stack step_* flow
JS 逆向 25 reverse_hook reverse_patch reverse_search reverse_preload
CDP 逆向 19 reverse_cdp_hook reverse_call_fn reverse_heap reverse_trace
反检测 7 antidetect_presets fingerprint_ua canvas_noise font_randomize
指纹虚拟 20+ fingerprint_screen fingerprint_hardware fingerprint_webgl
工作流 4 workflow_list workflow_get workflow_run workflow_stop
批量与重试 2 batch retry
系统 8 ping mcp_result mcp_status fbro_version shutdown
编码与工具 5 base64_encode/decode uri_encode/decode aliases

📚 完整 API 参考:skills/AI浏览器MCP.md


🏗 架构

AI 代理 (Cursor/Claude/Cline)
    │ stdio MCP / HTTP POST / WebSocket
    ▼
AI-Browser-MCP Server  ← mcp_bridge.js (stdio 桥接)
    │ FBrowser CEF API
    ▼
真实浏览器窗口 (CEF 内核)
模块 文件 职责
入口 src/main.wsv GUI + FBrowser 初始化
MCP 核心 src/MCP_Server.wsv (~7800 行) JSON-RPC、工具注册、sync-wait、CDP/Debugger
分派层 src/MCP_Server_Core/Form/VIP/System/Workflow/Reverse.wsv 268 工具实现
HTTP/WS src/MCP_Server_HTTP.wsv 欢迎页、健康检查、/mcp 端点
事件 Hook src/MCP_BrowserEvents.wsv 生命周期/网络/回调事件
桥接 mcp_bridge.js stdio ↔ HTTP,Cursor/IDE 接入

📦 下载

平台 大小
AI-Browser-MCP-x64-v2.8.0.zip Windows x64 ~157 MB
AI-Browser-MCP-win32-v2.8.0.zip Windows 32-bit ~136 MB
AI-Browser-MCP-cpp-x64-v2.8.0.zip C++ 对照 x64 ~396 KB
AI-Browser-MCP-cpp-win32-v2.8.0.zip C++ 对照 win32 ~396 KB

环境要求:Windows 10/11 · Node.js 18+(Cursor 桥接)· 64 位系统优先用 x64


📁 仓库结构

ai-browser-mcp/
├── CEFbro/AI-Fbowser-Mcp/
│   ├── src/              # 火山 .wsv 源码(MCP 核心,开源主体)
│   ├── generated-cpp/    # 火山生成 C++ 对照(release-x64/、release-win32/)
│   ├── docs/             # 客户手册、配置说明、快速上手
│   ├── skills/           # Agent 技能书 + 268 工具参考 + 火山 API 知识库
│   ├── workflows/        # 工作流 JSON
│   ├── scenarios/        # 场景脚本(逆向、Hook 测试)
│   ├── mcp_bridge.js     # Cursor stdio 桥接
│   └── mcp_config.json   # MCP 服务配置
├── release/              # 发行辅助脚本
├── CONTRIBUTING.md       # 贡献与发版指南
├── CHANGELOG.md          # 版本更新日志
├── OPEN_SOURCE.md        # 开源公告(中文)
├── OPEN_SOURCE_EN.md     # Open-source announcement (English)
└── README.md

📖 文档

文档 读者
268 工具完整参考 开发者 / Agent
客户使用手册 终端用户
MCP 工具配置说明书 部署 / 集成
使用技能书 开发者 / Agent
场景与 Hook 测试 逆向 / persist Hook
快速上手(中文/SEO) 中文检索
Quick Start (English) International SEO

🤝 参与

❓ FAQ

问题 解决
/health 失败 确认 exe 已启动;检查 9222 端口未被占用
AI 代理连不上 先启动 exe → node mcp_bridge.js --check;Cursor 用 stdio 桥接勿直连 URL
工具调用超时 增大 mcp_config.jsondefault_timeout_ms 或给工具加 max_ms 参数
POST body 抓不到 默认网络层不记 POST 正文,用 browser_inject persist Hook
调试器断点不命中 确认 browser_debugger_enable 已执行且页面已触发目标事件
x64 vs win32 64 位系统优先 x64;仅 32 位环境用 win32

📄 许可证

MIT License


如果这个项目对你有帮助,欢迎 Star ⭐