mcpField
B
browser-mcp-cdp

browser-mcp-cdp

本地服务
github.com/zhiqi-li浏览器自动化027 周前更新
代码仓库

关于 browser-mcp-cdp

browser-mcp-cdp 是通过 Chrome DevTools Protocol 控制本地 Chrome 的 MCP 服务。它使用可丢弃的配置快照保留登录状态，同时避免改动原始配置，并允许多个客户端共享浏览器。

主要功能

  1. 01控制本地 Chrome
  2. 02隔离式配置快照
  3. 03多个客户端共享浏览器
  4. 04网页导航与 JavaScript 执行
  5. 05点击、填写、截图和读取页面
  6. 06管理标签页与滚动页面

适用场景

  1. 01在登录状态下检查 Gmail 或内部仪表盘
  2. 02让 Agent 操作网页而不修改原始 Chrome 配置
  3. 03多个 MCP 客户端共用同一浏览器会话

MCP 相关

它通过 MCP 向客户端提供本地 Chrome 浏览器操作工具，并以共享 broker 管理多个客户端连接。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "zhiqi-li-browser-mcp-cdp": {
      "command": "npx",
      "args": [
        "-y",
        "browser-mcp-cdp"
      ]
    }
  }
}
启动命令npx -y browser-mcp-cdp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmbrowser-mcp-cdp0.1.2

工具

13

收录的工具列表 · 更新于 2 周前

参数类型必填说明
urlstring是要导航到的 URL

详细介绍

browser-mcp-cdp

一个模型上下文协议（MCP）服务，可通过 Chrome DevTools Protocol 驱动本地真实的 Chrome。专为需要访问已登录会话（Gmail、内部仪表板、银行账户等）的 Agent 设计，无需将凭据上传到云服务。

为什么还要另一个浏览器 MCP？

与其他方案相比，各有取舍：

browser-mcp-cdpPlaywright MCPChrome DevTools MCP
浏览器你的本地 Chrome托管的 Playwright Chromium你的本地 Chrome
登录状态✅ 个人资料快照（Cookie、登录信息、IndexedDB）❌ 全新个人资料✅ 真实个人资料（会修改它）
个人资料隔离✅ 启动时复制，不会触碰真实个人资料不适用⚠️ 直接连接
多客户端✅ MCP 客户端共享同一个代理❌ 每个客户端独立❌ 每个客户端独立
依赖项仅 Node（无需下载 Playwright）Playwright + 浏览器仅 Node

个人资料快照模式意味着你可以让 Agent“查看我的邮件”——它能看到已登录的 Gmail，但 Agent 的操作绝不会修改你的真实 Chrome 个人资料。每个会话都会获得一份可丢弃的副本。

安装

claude mcp add browser -- npx -y browser-mcp-cdp

也可以手动添加到 ~/.claude.json / Claude Desktop 配置中：

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "browser-mcp-cdp"]
    }
  }
}

需要安装 Node 18+ 和 Google Chrome。

工具

工具用途
browser_navigate加载 URL，返回最终 URL 和标题
browser_evaluate在页面中运行 JS 并返回结果
browser_screenshot当前页面的 PNG 图片
browser_click通过 CSS 选择器点击
browser_click_at点击像素坐标位置（可穿透 iframe / 覆盖层）
browser_fill设置 input/textarea/select 的值
browser_wait_for等待选择器出现
browser_get_url当前 URL
browser_get_text页面或元素的可见文本
browser_get_html页面或元素的 outerHTML
browser_scroll按 (x, y) 像素滚动
browser_tabs列出已打开的标签页
browser_new_tab打开新标签页

环境变量

变量默认值
BROWSER_MCP_CHROME_PATH按操作系统自动检测
BROWSER_MCP_CHROME_PROFILE_ROOT操作系统标准的 Chrome 个人资料目录
BROWSER_MCP_BROKER_SOCKET_PATH~/.browser-mcp/broker.sock
BROWSER_MCP_BROKER_LOCK_PATH~/.browser-mcp/broker.lock
BROWSER_MCP_BROKER_IDLE_TIMEOUT_MS600000（10 分钟）

工作原理

  1. 第一个 MCP 客户端连接时，会启动一个 代理子进程（脱离终端运行）。
  2. 代理会将 Chrome 个人资料中的 Cookie、本地存储和登录数据复制到临时目录。
  3. 代理使用 --user-data-dir=<temp> 和 --remote-debugging-port 启动 Chrome。
  4. 后续 MCP 客户端通过 Unix 套接字连接到同一个代理 → 共享同一个 Chrome。
  5. 空闲达到 BROKER_IDLE_TIMEOUT_MS 后，代理会退出；临时个人资料也会被删除。

安全

此服务允许大模型在已登录你账户的浏览器中执行任意 JavaScript。仅与可信的模型和提示词搭配使用。个人资料快照可以限制损害（不会对你的真实 Chrome 进行持久性修改），但在会话期间，Agent 可以读取 Cookie、会话令牌，以及你登录后可见的任何数据。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。