Browser Mcp Cdp

io.github.zhiqi-li由 GitHub 账号 zhiqi-li 发布v0.1.2更新于 Oct 27, 2026

Local Chrome via CDP with profile-snapshot isolation and shared-broker multi-client support

已验证STDIO仅桌面网页搜索与抓取浏览器自动化

概览

AI 生成的概览

通过 Chrome DevTools 协议驱动本机真实 Chrome 的 MCP 服务器，使用 Chrome 配置文件的临时副本，让助手看到你已登录的会话。

可以做什么
  • 打开网址并返回最终 URL、标题、页面或元素的可见文本与 HTML
  • 在页面中执行 JavaScript 并取回结果
  • 截取 PNG 截图，按像素滚动页面
  • 按 CSS 选择器或像素坐标点击，填写输入框、文本域和下拉框，等待选择器出现
  • 列出已打开的标签页并新建标签页
  • 通过独立的后台 broker 进程让多个 MCP 客户端共用一个 Chrome 实例
适用场景
适合需要在你已登录的网站（如网页邮箱、内部仪表盘、银行门户）中操作的场景，无需把凭据交给云端浏览器。也适合多个 MCP 客户端需要共享同一个浏览器会话的配置。
运行要求
以本地进程方式通过 npx 运行（npm 包 browser-mcp-cdp），需要 Node 18+ 和已安装的 Google Chrome。可选环境变量可指定 Chrome 路径、配置文件根目录、broker 套接字与锁文件路径以及 broker 空闲超时。仅支持桌面端。
安装前请注意
助手可在已登录你账号的浏览器中执行任意 JavaScript，并在会话期间读取 Cookie、会话令牌以及对你可见的任何数据。仅在你信任的模型和提示下使用。配置文件快照可避免对真实 Chrome 配置造成持久修改，但临时副本只在 broker 空闲超时退出后才会删除。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Browser Mcp Cdp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

browser-mcp-cdp

A Model Context Protocol (MCP) server that drives your real local Chrome via the Chrome DevTools Protocol. Designed for agents that need access to your logged-in sessions (Gmail, internal dashboards, banking, etc.) without uploading credentials to a cloud service.

Why another browser MCP?

Different tradeoffs from the alternatives:

browser-mcp-cdpPlaywright MCPChrome DevTools MCP
BrowserYour local ChromeManaged Playwright ChromiumYour local Chrome
Login state✅ Snapshot of your profile (cookies, logins, IndexedDB)❌ Fresh profile✅ Real profile (modifies it)
Profile isolation✅ Copy-on-start, real profile untouchedN/A⚠️ Direct attach
Multi-client✅ Shared broker across MCP clients❌ Per-client❌ Per-client
DependenciesNode only (no Playwright download)Playwright + browsersNode only

The profile snapshot pattern means you can ask an agent to "check my email" — it sees your Gmail logged in — but the agent's actions never modify your real Chrome profile. Each session gets a disposable copy.

Install

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

Or add manually to ~/.claude.json / Claude Desktop config:

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

Requires Node 18+ and Google Chrome installed.

Tools

ToolPurpose
browser_navigateLoad a URL, return final URL + title
browser_evaluateRun JS in the page, return result
browser_screenshotPNG of current page
browser_clickClick via CSS selector
browser_click_atClick at pixel coordinates (pierces iframes / overlays)
browser_fillSet value on input/textarea/select
browser_wait_forWait for a selector to appear
browser_get_urlCurrent URL
browser_get_textVisible text of page or element
browser_get_htmlouterHTML of page or element
browser_scrollScroll by (x, y) pixels
browser_tabsList open tabs
browser_new_tabOpen a new tab

Environment variables

VarDefault
BROWSER_MCP_CHROME_PATHAuto-detected per OS
BROWSER_MCP_CHROME_PROFILE_ROOTOS-standard Chrome profile dir
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 min)

How it works

  1. First MCP client connection spawns a broker subprocess (detached).
  2. Broker copies your Chrome profile's cookies/local storage/login data to a temp dir.
  3. Broker launches Chrome with --user-data-dir=<temp> and --remote-debugging-port.
  4. Subsequent MCP clients connect to the same broker over a Unix socket → they share one Chrome.
  5. Broker exits after BROKER_IDLE_TIMEOUT_MS of no activity; temp profile is deleted.

Security

This server lets an LLM execute arbitrary JavaScript in a browser that is logged into your accounts. Only use with models and prompts you trust. Profile snapshotting limits damage (no persistent mutations to your real Chrome), but the agent can read cookies, session tokens, and any data visible to logged-in you for the duration of the session.

License

MIT

来源：README.md，提交 0cf6e0b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分