MCP 客户端 (Claude Code / Cursor / ZCode ...)
        │  stdio
        ▼
browser-mcp (本仓库，Python MCP server)
        │  subprocess
        ▼
agent-browser CLI  ──►  本地 Chrome (headless 或 headed)

# 安装 CLI（需要 Node.js）
npm install -g agent-browser

# 下载它自带的 Chrome for Testing（首次安装必做）
agent-browser install

agent-browser --version
agent-browser open example.com && agent-browser snapshot -i
# 能看到页面的可交互元素列表，说明 agent-browser 就绪

git clone https://github.com/huaka1/browser-mcp.git
cd browser-mcp

# 建议用虚拟环境
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

# 可编辑安装（同时注册 `browser-mcp` 命令行入口）
pip install -e .

browser-mcp --help               # 或：python -m browser_mcp.server

请帮我安装并配置 browser-mcp（一个让 AI agent 控制浏览器的 MCP server）。
按步骤执行，每步验证通过后再进入下一步；失败就停下来告诉我原因和修复建议。

【前提检查】
- 跑 `node --version`；失败就提示我装 Node.js（macOS: `brew install node`）
- 跑 `python3 --version` 确认 ≥ 3.10；失败就提示我装 Python 3.10+

【1. 安装浏览器引擎】
  npm install -g agent-browser
  agent-browser install              # 下载 Chrome for Testing，约 1-2 分钟
  验证：agent-browser open example.com && agent-browser snapshot -i
        能列出页面可交互元素即成功

【2. 克隆并安装 browser-mcp】
  git clone https://github.com/huaka1/browser-mcp.git ~/browser-mcp
  cd ~/browser-mcp
  python3 -m venv .venv
  source .venv/bin/activate          # Windows: .venv\Scripts\activate
  pip install -e .
  验证：`python -m browser_mcp.server` 能启动（或 browser-mcp 在 PATH 中）

【3. 生成 MCP 配置 — 关键：合并而非覆盖】
  - 用 `~/browser-mcp/.venv/bin/python` 的绝对路径作为 command
  - 定位我的 MCP 配置文件：优先当前项目 ./.mcp.json，其次 ~/.claude.json
  - 若文件已存在：解析 JSON，在 mcpServers 下新增 "browser" 键（保留其它配置）
  - 若不存在：新建文件，写入 {"mcpServers": { ... }}
  - browser 配置内容：
      "browser": {
        "command": "<venv python 绝对路径>",
        "args": ["-m", "browser_mcp.server"],
        "env": { "BROWSER_MCP_HEADED": "1" }
      }

【4. 收尾】
  告诉我重启 MCP 客户端以加载新配置。
  重启后引导我调用 browser_navigate 打开 https://example.com 做最终验证——
  返回页面快照即代表安装链路打通。

{
  "mcpServers": {
    "browser": {
      "command": "/你/克隆的路径/browser-mcp/.venv/bin/python",
      "args": ["-m", "browser_mcp.server"],
      "env": {
        "BROWSER_MCP_HEADED": "1"
      }
    }
  }
}

"env": {
  "BROWSER_MCP_HEADED": "1"
}