Chrome MCP
Chrome MCP
Chrome MCP 向 Model Context Protocol 客户端暴露真实的 Chrome 标签页,而无需将浏览器会话复制到另一个引擎中。Chrome 扩展通过 chrome.debugger 控制用户现有配置文件中的标签页,同时一个持久的本地守护进程协调一个或多个 Chrome 配置文件与 MCP 进程。
架构
MCP client ──stdio── MCP bridge ──authenticated HTTP── persistent daemon
│
├── WebSocket ── Chrome extension/profile A ── tabs
└── WebSocket ── Chrome extension/profile B ── tabs标签页就是浏览器会话。关闭会话即关闭其 Chrome 标签页。
每个扩展安装代表一个 Chrome 配置文件/实例。
守护进程为每个已连接实例分配全局数字
session_id值。守护进程独立于 MCP 客户端的重启而持续存在,并且没有托盘图标。
操作通过
chrome.debugger使用 Chrome DevTools Protocol,因此被评估的 JavaScript 不会被页面 CSP 阻止。由于无需会话迁移,认证状态、Cookie、IndexedDB、service worker、证书、扩展和浏览器指纹都保留在原始 Chrome 配置文件中。
Related MCP server: Local Browser MCP
安装
需要 Chrome 116 或更高版本。
bun install在每个应可用的 Chrome 配置文件中加载扩展:
打开
chrome://extensions。启用开发者模式。
选择加载已解压的扩展程序。
选择此仓库的
extension目录。打开扩展弹出窗口,为实例指定一个易识别的名称,并在适当时选择设为默认。
Chrome 必须能够访问 ws://127.0.0.1:55333。守护进程只接受来自 chrome-extension:// 来源的扩展 WebSocket,并且仅绑定到 localhost。
MCP 客户端配置
{
"mcpServers": {
"chrome": {
"command": "bunx",
"args": ["-y", "@cypherpotato/chrome-mcp", "--mcp"]
}
}
}对于在 bun link 之后的本地检出,请将 MCP 配置直接指向链接后的可执行文件,而不是使用 bunx:
{
"command": "C:\\Users\\<user>\\.bun\\bin\\chrome-mcp-electron",
"args": ["--mcp"]
}CLI
chrome-mcp-electron --mcp
chrome-mcp-electron --daemon
chrome-mcp-electron --status
chrome-mcp-electron --stop-daemon
chrome-mcp-electron --help--mcp 会在必要时在后台启动守护进程,然后通过 stdio 提供 MCP 服务。关闭 MCP 进程不会停止守护进程,也不会断开 Chrome 扩展的连接。
工具
公共工具名称和输入模式与 Browser MCP 一致:
browser_toggle_sessionbrowser_import_sessionbrowser_run_actionsbrowser_get_context
browser_toggle_session({ "action": "start" }) 会在默认 Chrome 实例中打开一个标签页。当连接了多个实例时,请在扩展弹出窗口中选择默认实例。扩展报告的现有标签页也会获得 session_id 值,并且可以直接控制。
browser_get_context 列出所有已连接实例及其标签页。URL 返回时不带查询字符串。
多个 Chrome 实例与配置文件
在每个配置文件中分别安装已解压的扩展。每次安装都会创建一个存储在该配置文件中的稳定随机实例 ID,并自动重新连接到守护进程。实例名称不必唯一,但建议使用不同的名称。
在扩展或 service worker 重启后,守护进程会协调标签页。只要所属扩展已连接且标签页仍然存在,会话就保持可寻址状态。
能力
browser_run_actions 支持与 Browser MCP 相同的浏览器辅助功能:
快照与 JavaScript 评估;
点击、右键单击、悬停、拖拽、滚动和键入;
导航;
截图;
控制台与网络日志;
Chrome 仍保留时的网络请求详情与响应体;
响应式视口模拟与配色方案模拟;
JavaScript alert、confirm 和 prompt 处理。
限制
Chrome 每个标签页只允许一个调试器连接。在控制该标签页之前,请先关闭 DevTools。打开 DevTools 可能会分离扩展。
Chrome 内部页面、扩展页面、Chrome Web Store 以及其他受限方案无法被控制或作为智能体会话暴露。
扩展必须安装在每个配置文件中;一个配置文件无法检查另一个配置文件的标签页。
当标签页处于连接状态时,调试器权限会显示一条 Chrome 警告。
响应体可能会从 Chrome 的网络缓冲区中过期失效。
原生触摸输入和浏览器内部的下载 CDP API 不会通过
chrome.debugger暴露。
开发
bun run check
bun run test测试套件使用模拟扩展 WebSocket 客户端,在不打开 Chrome 的情况下验证持久守护进程生命周期、认证、标签页/会话协调、多实例、默认实例选择、操作路由和重连行为。
内部协议记录在 docs/protocol.md 中。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Live browser debugging for AI assistants — DOM, console, network via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to control and interact with the user's real Chrome browser session, leveraging existing logins, cookies, and extensions for AI-driven automation.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables local control of existing Chrome/Chromium browser tabs through MCP, including tab management, navigation, content reading, screenshots, and page interaction.Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to directly operate your existing logged-in Chrome profiles, including cookies and extensions, without re-authentication or a headless browser. It provides tools for managing tabs, navigating, reading pages, clicking, typing, and launching profiles.MIT
- AlicenseBqualityCmaintenanceEnables MCP clients to drive a real Chromium browser for automation, including navigation, JavaScript execution, CDP commands, network capture, and multi-tab control.7GPL 3.0