Ai Browser Mcp

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

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

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

[](https://github.com/AI-XiaoDao/ai-browser-mcp/releases/tag/v2.8.0) [](LICENSE) [](https://github.com/AI-XiaoDao/ai-browser-mcp/releases) []() []() []()

⚡ [3 步上手](#-3-步上手) · [场景演示](#-典型场景) · [对比 Playwright](#-vs-playwright--puppeteer) · 下载 · [开源公告](OPENSOURCE.md) · [English](OPENSOURCEEN.md)

---

✨ 一句话介绍

下载 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](CEFbro/AI-Fbowser-Mcp/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 |

📖 查看完整话术示例

帮我把 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 自动换策略或报告原因

---

🆚 VS Playwright / Puppeteer

| 维度 | 自建 Playwright / Puppeteer | AI-Browser-MCP | |------|---------------------------|-------------------| | 上手 | 写脚本、装驱动、调试选择器 | 下载 zip → 运行 exe → AI 一句话 | | AI 集成 | Agent 现写代码，易出错 | 268 个预封装 MCP 工具，Agent 直接调用 | | 浏览器 | 常无头 / 需额外配置 | FBrowser CEF 真实窗口，行为接近用户 | | 逆向 / 断点 | 需自己 Hook + DevTools | 内置 browser_inject、CDP 调试器、场景脚本 | | 隐私 | 视部署方式 | 默认 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](CEFbro/AI-Fbowser-Mcp/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 工具完整参考](CEFbro/AI-Fbowser-Mcp/skills/AI浏览器MCP.md) | 开发者 / Agent | | [客户使用手册](CEFbro/AI-Fbowser-Mcp/docs/客户使用手册.md) | 终端用户 | | [MCP 工具配置说明书](CEFbro/AI-Fbowser-Mcp/docs/MCP工具配置说明书.md) | 部署 / 集成 | | [使用技能书](CEFbro/AI-Fbowser-Mcp/docs/使用技能书.md) | 开发者 / Agent | | [场景与 Hook 测试](CEFbro/AI-Fbowser-Mcp/skills/场景与Hook测试.md) | 逆向 / persist Hook | | [快速上手（中文/SEO）](CEFbro/AI-Fbowser-Mcp/docs/QUICKSTARTZH.md) | 中文检索 | | [Quick Start (English)](CEFbro/AI-Fbowser-Mcp/docs/QUICKSTARTEN.md) | International SEO |

---

🤝 参与

• Issue：Bug 报告 · 功能建议
• PR：见 [CONTRIBUTING.md](CONTRIBUTING.md)，改 src/*.wsv 提 PR
• 交流：QQ 212577526 · 群 737680767 · 火山编程交流群

❓ 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](LICENSE)

---

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AI-XiaoDao
• Source: AI-XiaoDao/ai-browser-mcp
• License: MIT
• Homepage: https://github.com/AI-XiaoDao/ai-browser-mcp#readme

Install and usage instructions live in the source repository linked above.