Skip to content

客户使用手册.md

Latest commit

 

History

History
293 lines (201 loc) · 11.1 KB

客户使用手册.md

File metadata and controls

293 lines (201 loc) · 11.1 KB
Raw

AI浏览器 MCP — 客户使用手册

版本 3.2.0 · 在线阅读：http://127.0.0.1:9222/docs/客户使用手册.md
配套文档：MCP工具配置说明书 · 完整 HTML 文档

一、产品是什么？

AI浏览器 是一款内置浏览器的桌面程序。启动后会在本机开放 MCP 服务（默认端口 9222），让 Cursor、Claude Desktop、任意 MCP 客户端 或您自己的程序像「远程操控浏览器」一样：

  • 打开指定网页
  • 自动填表、点击按钮
  • 读取页面文字与元素
  • 查看网络请求记录
  • 截图、改指纹、断点调试、拦截修改接口等（发布包已全部包含）

您不需要手写复杂代码——在 Cursor 里用自然语言描述任务，AI 会调用 334 个已封装好的浏览器工具完成操作。

二、您能得到什么？

能力 说明
打开/刷新/后退网页 日常浏览自动化
读标题、读元素、执行简单 JS 信息采集
自动填表、点击 登录、下单、录入
网络请求列表 看 URL、状态码（不含 POST 正文）
工作流批量执行 多步骤任务编排
截图 / PDF 页面留存
CDP 深度调试 / 断点 逆向、定位 sign 算法
指纹 / 代理 / 资源拦截修改 防检测、改包

说明：从 GitHub Releases 下载的 zip 已包含上述全部能力，解压即用。

说明：关闭浏览器窗口会退出整个程序（控制台版）。保持 MCP 服务运行请最小化控制台窗口。

三、系统要求

  • Windows 10 / 11（64 位）
  • 已安装 Node.js（仅在使用 Cursor 桥接 mcp_bridge.js 时需要）
  • 本机可访问互联网（访问目标网站时）
  • 防火墙允许本机 127.0.0.1:9222（默认仅本机访问，安全）

四、安装与首次启动

  1. 解压或安装发布包，找到 AI-Fbowser-Mcp.exe
  2. 双击启动，等待主窗口出现
    • 关闭浏览器窗口 = 退出程序（控制台版无托盘）；保持运行请最小化控制台窗口
    • 彻底退出：在 Cursor 里说「关闭AI浏览器」（调用 browser_shutdown），或任务管理器结束进程
    • 自动启动：配置好 Cursor 后，Cursor 打开时若服务未运行会自动拉起 exe（AI_BROWSER_AUTO_START=0 可关闭）
  3. 用浏览器打开：http://127.0.0.1:9222/health
    • 看到 "status":"ok" 表示服务正常
  4. 打开欢迎页控制台：http://127.0.0.1:9222/
    • 可查看工具数量、复制 Cursor 配置、搜索工具名

exe 同目录重要文件：

文件 作用
mcp_config.json 端口、日志等配置
mcp_connect.json 启动后自动生成，含连接地址
mcp_bridge.js 给 Cursor 用的桥接脚本
docs/ 本手册及配置说明（随安装包附带）

五、三种使用方式

方式 A：在 Cursor 里用自然语言（推荐）

适合：不懂编程的客户、日常「帮我打开某网站并操作」。

  1. 保持 AI-Fbowser-Mcp.exe 运行
  2. 按 配置说明书 配置 Cursor 的 mcp.json
  3. 重启 Cursor，在对话中直接说，例如：
您可以说 AI 会做什么
「打开百度」 browser_navigate 打开 https://www.baidu.com
「当前页面标题是什么」 browser_get_title
「在搜索框输入天气并点击搜索」 fill_set_value + fill_click
「列出最近的网络请求」 browser_network list
「刷新页面」 browser_reload
「滚动商品列表，采标题价格 JSON」 evaluate 滚动 + dom_query / collect
「扫描 POST，标出疑似加密字段」 reverse_prepare + inject Hook + 网络对比
「提交时下断点，定位 sign 函数给源码」 debugger_*
「登录并导出订单表前 20 行」 fill_* + DOM 读取
「把这套流程存成 workflow 并跑一遍」 workflow_*

更多场景见 GitHub README（开源仓库）。

  1. 自检连接（可选）：
node mcp_bridge.js --check

方式 B：欢迎页控制台

适合：快速查看服务状态、浏览全部工具、复制配置。

  • 地址：http://127.0.0.1:9222/
  • 文档：http://127.0.0.1:9222/docs/

方式 C：自有脚本 / 其他 MCP 客户端

适合：集成到公司内部系统。

  • HTTP 接口：POST http://127.0.0.1:9222/mcp
  • 协议：标准 MCP JSON-RPC（tools/call）
  • HTTP JSON-RPC 调用示例见 完整文档 的「MCP 协议流程」一节

六、Cursor 接入（分步说明）

第 1 步：确认 Node.js

命令行执行 node -v，能显示版本号即可。

第 2 步：编辑 Cursor 配置

在用户目录或项目下创建/编辑 .cursor/mcp.json（路径以 Cursor 版本为准）：

{
  "mcpServers": {
    "ai-browser": {
      "command": "node",
      "args": ["您的安装路径/mcp_bridge.js"],
      "env": {
        "AI_BROWSER_MCP_HTTP_POST": "http://127.0.0.1:9222/mcp"
      }
    }
  }
}

将 args 中的路径改为您实际的 mcp_bridge.js 位置（一般在 exe 同目录）。

也可在欢迎页 http://127.0.0.1:9222/ 点击 「复制 Cursor 配置」 直接复制。

第 3 步：重启 Cursor

配置保存后完全退出并重新打开 Cursor，在 MCP 工具列表中应能看到 ai-browser 相关工具。

第 4 步：试一句

在对话输入：「用浏览器打开 https://www.example.com 并告诉我标题」。

七、常见业务场景

7.1 日常打开网页

对 AI 说：「打开目标网站」或「导航到 https://example.com」。

7.2 自动填表登录

对 AI 说：「在 #username 填入 xxx，在 #password 填入 yyy，点击登录按钮」。
（需页面有稳定的选择器；复杂站点可让 AI 先 browser_dom_query 分析结构。）

7.3 查看接口 / 网络活动

对 AI 说：「开启网络日志并列出最近 50 条请求」。
注意：默认看不到 POST 请求体。需开启详细网络记录：

# 方式1: MCP 工具
browser_network detail_enable  # 开启详细记录(含POST body)
browser_network list           # 列出网络日志

# 方式2: 测试脚本 (需先启动 AI-Fbowser-Mcp.exe)
node full_test.js

7.4 批量重复操作（工作流）

对 AI 说：「执行工作流 hello」→ 对应 workflow_run。
预置工作流在 workflows/ 目录，可按需定制 JSON 步骤链。

7.5 数据采集（一句话）

对 AI 说：「滚动加载商品列表，把标题、价格、链接采成 JSON」。

AI 通常会：打开页面 → 滚动或点「加载更多」→ 读 DOM → 整理成表格或 JSON 返回。
若数据为空：说明是否要先登录、多滚几屏，或让 AI 先试探选择器。

7.6 逆向算法（找加密字段）

对 AI 说：「扫描 XHR/fetch 的 POST，标出疑似加密的字段」。

注意：普通网络列表看不到 POST 正文，AI 会用 Hook 注入（browser_inject）或资源拦截来抓 body。
开启详细记录后即可查看：

browser_network detail_enable
browser_network list
browser_network detail_enable --skip-navigate   # 当前已在目标页时

逆向 vs 定位：逆向是找「哪个字段/请求被加密」；定位是找「加密逻辑在哪个 JS 函数」（发布包内置 CDP 调试器，见第八章）。

7.7 定位算法（找 sign 函数）

对 AI 说：「提交时下断点，跟到计算 sign 的函数，把源码片段给我」。

此能力使用 CDP 调试器（发布包已内置）。AI 会设断点、读 call stack 与源码。
断点不命中时：改在 fetch 发送处断住，或让 AI 在页面里搜索 sign / md5 相关脚本。

7.8 页面卡住 / 调试后无响应

对 AI 说：「恢复页面并停止加载」：

browser_debugger_resume   # 恢复调试器暂停
browser_stop              # 停止页面加载

或在对话中让 AI 调用 browser_restore_gui、browser_reload。

八、全功能说明

从 GitHub Releases 下载 AI-Browser-MCP-x64-*.zip：

  • 全部 334 个工具可用（截图、CDP 调试器、指纹、资源拦截、工作流等）
  • 解压 → 运行 AI-Fbowser-Mcp.exe → 接入 AI 代理即可
  • 一般无需修改 mcp_config.json 中的额外字段

二次开发者编译说明见仓库 CONTRIBUTING.md。

九、修改配置时要注意

操作 说明
改端口 修改 mcp_config.json 的 port，重启后 Cursor 的 URL 也要一起改
开网络日志 默认已开启 enable_network_log: true
改配置后 必须重启 AI-Fbowser-Mcp.exe 才生效
详细字段 见 MCP工具配置说明书

十、常见问题（客户版）

问题 解决办法
Cursor 里工具用不了 先启动 AI-Fbowser-Mcp.exe → 运行 node mcp_bridge.js --check
提示连接被拒绝 程序未启动或端口被占用；检查 9222 端口
关了窗口还能用吗？ 关闭浏览器窗口=退出程序；最小化控制台窗口则 MCP 仍在运行
怎么完全退出？ 关闭浏览器窗口 或 控制台窗口 (Ctrl+C)
AI 说找不到浏览器 等几秒再试，或打开一次主窗口让浏览器实例创建
高级工具报错 确认使用 GitHub Release 下载包；重启 exe；见 Issue
网络列表是空的 需要先打开网页产生请求；确认 enable_network_log 为 true
文档网页打不开 确认安装目录下有 docs 文件夹（重新安装/编译发布包）
多个脚本同时跑乱了 同一台机器不要并行跑多个自动化脚本，请顺序执行
扫描脚本报 timeout 执行 browser_debugger_resume + browser_stop 恢复页面；勿同时开多个 MCP 调用
采集结果是空的 是否要登录；说「滚动 N 屏后再采」；让 AI 先 dom_query 试探
逆向和定位有什么区别？ 逆向找加密字段；定位找加密函数（CDP 断点 + 栈 + 源码）
接口加密参数怎么看？ 见 7.6 节；对 AI 说「扫描 POST 加密字段」或 browser_network detail_enable

十一、文档与支持

资源 地址
本手册 docs/客户使用手册.md
配置说明 docs/MCP工具配置说明书.md
在线文档 http://127.0.0.1:9222/docs/
健康检查 http://127.0.0.1:9222/health
工具列表 http://127.0.0.1:9222/tools/list

技术支持

  • QQ：212577526
  • QQ 群：737680767
  • 微信：XSMZAS1
  • 火山编程交流群：点击加入

AI浏览器 MCP Server v3.2.0 · 334 个浏览器自动化工具 · 基于火山 FBrowser CEF 内核