安装步骤

1. 将项目中提供的浏览器插件 src/cdp_bridge/tmwd_cdp_bridge 文件夹加载到 Chrome 或其他 Chromium 浏览器。
2. 在 MCP 客户端配置 CDP Bridge MCP。

然后就可以正常使用了。下面详细介绍上述安装步骤。

首次使用：加载扩展后首次连接 WebSocket 会产生 ERR_CONNECTION_REFUSED 报错，这是正常的。扩展内置自动重连机制（每 ~5 秒探测一次），当检测到后端服务启动后会自动恢复连接，无需手动重启扩展。

演示视频

快速使用

下面是默认配置下最快的使用流程：

1. 安装 uv。
2. 在 Chrome 或其他 Chromium 浏览器中打开 chrome://extensions/，开启“开发者模式”。
3. 点击“加载已解压的扩展程序”，选择 src/cdp_bridge/tmwd_cdp_bridge 文件夹。
4. 在 MCP 客户端里添加 cdp-bridge。

在任意客户端配置MCP：

{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge@latest"]
    }
  }
}

配置完成后，在浏览器里打开任意页面，然后在大模型客户端让模型执行网页操作即可。扩展会自动连接 MCP 进程启动的 WebSocket 服务；如果首次看到 ERR_CONNECTION_REFUSED，等待几秒自动重连即可。

详细使用

使用流程

1. 加载浏览器扩展（参考下方步骤）
2. 配置 MCP 客户端（参考下方步骤）
3. 使用任意浏览器工具（如 browser_get_tabs），MCP 服务启动后 WebSocket 服务会自动就绪
4. 浏览器扩展会在数秒内自动连接，之后即可正常使用所有工具

启动参数

注意：--ws-port 是浏览器扩展连接后端的端口；--port 是 MCP 客户端连接后端的 HTTP 端口。两者不是同一个端口。

streamable-http 模式（先启动服务，再注册）

claude mcp add cdp-bridge --transport streamable-http http://127.0.0.1:8000/mcp ```

配置 MCP

先确认电脑上已安装 uv。CDP Bridge MCP 通过 uvx cdp-bridge@latest 启动。

也可以通过环境变量传入 token 白名单

CDP_BRIDGE_TOKENS="team_alice,team_bob" uvx cdp-bridge@latest --transport streamable-http --port 8000 ```

不传 --transport 时默认使用 stdio。stdio 模式没有 MCP HTTP 端口；streamable-http 模式的 MCP 服务地址为 http://127.0.0.1:<port>/mcp。

标准配置

stdio 模式：

{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge@latest"]
    }
  }
}

如果需要修改浏览器扩展连接的 WebSocket 端口，把 --ws-port 加到 args 里：

{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge@latest", "--ws-port", "18767"]
    }
  }
}

streamable-http 模式：

先启动服务：

uvx cdp-bridge@latest --transport streamable-http --port 8000

如果同时要修改浏览器扩展连接的 WebSocket 端口：

uvx cdp-bridge@latest --transport streamable-http --port 8000 --ws-port 18767

再配置客户端连接：

{
  "mcpServers": {
    "cdp-bridge": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

如果你启用了多用户隔离，客户端应显式携带 Bearer token：

{
  "mcpServers": {
    "cdp-bridge": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp",
      "headers": {
        "Authorization": "Bearer team_alice"
      }
    }
  }
}

此时浏览器扩展弹窗中的 Token 也要填写成 team_alice。

streamable-http 模式，同时指定 MCP HTTP 端口和浏览器扩展 WebSocket 端口

uvx cdp-bridge@latest --transport streamable-http --port 8000 --ws-port 18767