AI Browser MCPServer
任意 AI 代理 · 一句话操控 Windows 真实浏览器
MCP 标准协议 | 217 工具全开放 | FBrowser CEF | MIT 开源 | Windows x64
一、产品概述
AI浏览器 MCP Server 是基于火山视窗 + FBrowser CEF 的 Windows 本地浏览器自动化 MCP 服务。启动AI浏览器.exe 后,本机 9222 端口对外提供标准 Model Context Protocol (MCP) 接口。不限于 Cursor —Claude Desktop、Cline、OpenCode、自研 Agent 或 HTTP/WebSocket 脚本均可调用 217 个 browser_* 工具。说一句话,Agent自动串联执行,无需手写 Playwright。
🎁 GitHub Release 下载即用
AI-Browser-MCP-x64-v2.6.0.zip(约 157MB)已包含全部 217 个工具(截图、CDP 调试器、指纹、网络拦截、工作流等),解压运行即可。
|
架构:AI 代理 → mcp_bridge.js(可选)→ MCP Server → FBrowser CEF → 真实网页
接入方式
| 方式 | 适用场景 | 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
|
二、核心亮点
▎自然语言驱动 在任意 MCP AI 代理里说需求,Agent 自动选工具链,逐步 sync-wait 等结果。
▎217 开箱工具 导航、填表、DOM、JS、网络、截图、CDP 断点、指纹、Hook、工作流等24 大类。
▎真实 CEF 窗口 FBrowser内核,页面行为贴近用户日常浏览,非纯无头模拟。
▎sync-wait + batch 同次调用内等待结果;一次请求串联多工具,省 Token、少轮次。
▎本机优先 默认 127.0.0.1:9222,数据不出机器;关主窗口后托盘常驻。
▎MIT 开源 11 个 .wsv 模块(~2 万行)+ generated-cpp + 文档 + 场景脚本,欢迎 PR。
三、一句话场景
不用写脚本、不用记 217 个工具名 — 复制话术到 AI对话即可。
| # | 场景 | 示例话术 | 主要工具 |
①
|
数据采集
|
滚动列表,采标题价格 JSON
| dom_query / collect
|
②
|
逆向分析
| 扫描 POST,标疑似加密字段
| inject Hook / network
|
③
|
定位算法
|
断点跟到 sign 函数,给源码
|
debugger_*
|
④
|
自动填表
|
登录后台,导出订单表
| fill_* / workflow
|
⑤
|
工作流复用
|
存成 JSON,下次一键跑
|
workflow_*
|
话术示例(复制到 AI 代理)
· 「帮我把商品列表滚动 5 屏,把标题、价格、链接采成 JSON。」 · 「打开 https://www.douyin.com ,扫描 XHR/fetch 的 POST,标出疑似加密字段并说明依据。」 · 「提交表单时下断点,跟到计算 sign 的 JS 函数,把函数名和源码片段给我。」 · 「用账号登录后台,进入订单页,导出前 20 行表格;把流程存成workflow JSON。」
以前 vs 现在
| 任务 | 传统 Playwright | AI浏览器 MCP |
采商品列表
|
写选择器 + 滚动循环 + 解析
| 一句话 → Agent 调 MCP
| 找 POST 加密字段
| 手动 DevTools Hook
| 一句话 + inject Hook
| 找 sign 函数
|
手动断点跟栈
| 一句话 + debugger_* 编排
|
固定流程
| 维护 cron + 脚本
| workflow JSON + workflow_run
|
实测演示
Cursor + Agent 一句话:自动注入 Hook、滚动触发请求、分析 33 条 POST。
四、强大扩展能力
| 扩展 | 说明 | 217 MCP 工具
|
导航/填表/DOM/JS/网络/截图/CDP/调试器/指纹 … 24 大类
| 工作流 JSON
| workflows/*.json 多步骤编排,workflow_run 一键复跑
| 事件 Hook
| 生命周期/网络/资源 persist 注入,逆向与改包
|
场景脚本
| scenarios/ 逆向扫描、Hook 测试、断点恢复范例
|
技能书 + 测试
| skills/ Agent 知识库;run_all_tests.js 全量回归
|
多通道接入
| stdio / HTTP POST / WebSocket 任意 AI 程序
|
工具速查
| 类别 | 示例工具 | 说明 |
导航
|
browser_navigate
|
打开 URL、后退、刷新
|
填表
|
browser_fill_click
|
填值、点击、选择
|
DOM
|
browser_dom_query
|
查询元素、属性、文本
|
网络
|
browser_network
| 请求列表、collect 聚合
|
Hook
|
browser_inject
| persist 注入抓 POST body
|
调试
|
browser_debugger_*
|
断点、单步、栈、源码
|
工作流
|
workflow_run
|
JSON 多步骤一键执行
|
五、3 步上手
1. 下载 AI-Browser-MCP-x64-v2.6.0.zip(~157MB)→ 解压 → 双击 AI浏览器.exe 2. 浏览器打开 http://127.0.0.1:9222/health ,确认"status":"ok" 3. 配置 mcp_bridge.js 接入 Cursor / Claude → 对 Agent 说任一句场景话术
Cursor 配置示例
{
"mcpServers": {
"ai-browser": {
"command": "node",
"args": ["路径/mcp_bridge.js"],
"env": {
"AI_BROWSER_MCP_HTTP_POST": "http://127.0.0.1:9222/mcp"
}
}
}
}
|
Release 解压目录请将 args 改为本机 mcp_bridge.js 路径。自检:node mcp_bridge.js--check
环境要求
· Windows 10 / 11(64 位) · Node.js 18+(仅 Cursor 桥接需要) · Release 已含 CEF 运行时,无需单独安装浏览器
六、开源与下载
| 内容 | 说明 | GitHub 仓库
|
https://github.com/AI-XiaoDao/ai-browser-mcp
| Release 运行包
| AI-Browser-MCP-x64-v2.6.0.zip — 217 工具全开放
|
权威源码
| CEFbro/AI浏览器/src/*.wsv(11 模块,MIT)
|
C++ 对照
|
generated-cpp/release-x64/
|
文档
| docs/ · skills/ · FORUM_POSTS.md · promo.html
|
仓库结构(摘要)
ai-browser-mcp/
├── CEFbro/AI浏览器/src/ # .wsv MCP 核心
├── generated-cpp/ # C++ 对照
├── docs/ · skills/ # 文档与技能书
├── mcp_bridge.js # Cursor 桥接
├── workflows/ · scenarios/ # 工作流与场景
└── release/pack-release.ps1 # 发版脚本
|
七、常见问题
Q:和 Playwright 有什么区别?
A:217 工具已封装成 MCP,AI 代理直接调用,不用写 Node 浏览器脚本。真实 FBrowser CEF 窗口,本机 9222。
Q:只能 Cursor 吗?
A:否。任意 MCP 客户端或 HTTP POST127.0.0.1:9222/mcp 均可。
Q:能抓 POST body 吗?
A:默认网络工具不记 POST 正文;须 browser_inject persistHook。见 douyin_xhr_encrypt_scan.js。
Q:Mac / Linux 支持吗?
A:当前仅 Windows x64。CEF 运行时随 Release 附带。
Q:逆向和定位有什么区别?
A:逆向找哪个请求/字段被加密;定位找加密逻辑在哪个 JS 函数(CDP 断点 + 栈 + 源码)。
参与与反馈
欢迎 Star ⭐ · GitHub Issue · Pull Request
宣传材料:FORUM_POSTS.md · promo.html · OPEN_SOURCE.md
许可证:MIT License
|
作者 QQ:212577526
|