AX

ai-xiaodao/ai-browser-mcp

浏览器自动化
42 stars 0 forks 质量 55 趋势 55

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

概览

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

README


✨ 一句话介绍

下载 AI-Browser-MCP-x64-v3.0.0.zip(~157MB),解压运行 AI-Fbowser-Mcp.exe。在 Cursor / Claude 里说句话,255 个预封装工具自动执行:采集数据、逆向 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」 navigate → evaluate → dom_query / collect
② 逆向 POST 「扫描 XHR/fetch,标出疑似加密字段」 reverse_prepare → inject Hook → network
③ 定位算法 「提交时下断点,跟到 sign 函数给源码」 debugger_enable → set_breakpoint → stack
④ 自动填表 「登录后台,导出订单前20行」 fill_* → click → collect
⑤ 固化复用 「存成 workflow,下次一键跑」 workflow_run

🆚 VS Playwright / Puppeteer

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

🔌 核心能力(255 工具 · 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 255 工具实现
HTTP/WS src/MCP_Server_HTTP.wsv 欢迎页、健康检查、/mcp 端点
事件 Hook src/MCP_BrowserEvents.wsv 生命周期/网络/回调事件
桥接 mcp_bridge.js stdio ↔ HTTP,Cursor/IDE 接入

📦 下载

包 平台 大小
AI-Browser-MCP-x64-v3.0.0.zip Windows x64 ~157 MB
AI-Browser-MCP-win32-v3.0.0.zip Windows 32-bit ~136 MB
AI-Browser-MCP-cpp-x64-v3.0.0.zip C++ 对照 x64 ~396 KB
AI-Browser-MCP-cpp-win32-v3.0.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 技能书 + 255 工具参考 + 火山模块 API 摘要
│   ├── workflows/        # 工作流 JSON
│   ├── mcp_bridge.js     # Cursor stdio 桥接
│   ├── full_test.js / regression_sync_wait.js  # 冒烟回归脚本
│   └── test_fixtures/    # 测试夹具
├── release/              # 发行辅助脚本
├── CONTRIBUTING.md       # 贡献与发版指南
├── CHANGELOG.md          # 版本更新日志
├── OPEN_SOURCE.md        # 开源公告(中文)
├── OPEN_SOURCE_EN.md     # Open-source announcement (English)
└── README.md

📖 文档

文档 读者
255 工具完整参考 开发者 / 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.json 中 default_timeout_ms 或给工具加 max_ms 参数
POST body 抓不到 默认网络层不记 POST 正文,用 browser_inject persist Hook
调试器断点不命中 确认 browser_debugger_enable 已执行且页面已触发目标事件
x64 vs win32 64 位系统优先 x64;仅 32 位环境用 win32

📄 许可证

MIT License


View this README on GitHub

安装

This server does not publish a one-line install command.

Open the repository installation guide

配置

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