Chrome Control MCP

为 AI 助手提供可见、精准的 Chrome 控制。设计上原生本地。

快速开始 · 工具目录 · 架构 · 安全 · 验证

自动化操作保持可见：粉红色框、AI CONTROL 徽标和脉动的代理光标会显示 AI 助手何时在控制 Chrome。面向模型的截图默认隐藏该覆盖层；文档截图可以开启。

为什么选择本项目

所有 43 个 MCP 工具 都使用严格的 JSON Schema。常驻的 MCP 进程保留会话和元素引用状态，而 Chrome 仍然是普通的用户可控浏览器。

Related MCP server: Chrome MCP Server

实际效果

这两张图片都是真实扩展直接执行 browser_screenshot 得到的结果，不是模型模拟。

测试支持致谢： Inflectra 的 UI Test Automation Playground 和 开源代码库 提供了实用且专注的浏览器场景。它们对本项目的完整 MCP 到 Chrome 路径测试功不可没。

快速开始

1. 安装构建要求

• Windows 10/11 x64、Linux x64 或 macOS

• Google Chrome 116+

• CMake 3.25+

• Qt 6.5+（包含 Core 和 Test 组件）

• C++20 编译器：Visual Studio 2022、GCC 或 Clang

• Node.js 20.19+

2. 构建并测试

npm ci
npm run build

默认输出：

PowerShell 用户也可以运行 ./scripts/build.ps1 -Configuration Release。这两种路径都以 warnings-as-errors 构建，并运行全部原生和扩展单元测试套件。

3. 准备 Chrome

npm run extension -- install

打开 chrome://extensions，启用 开发者模式，选择 加载已解压的扩展程序，然后选择命令打印的文件夹。Chrome 要求这个手动步骤来加载未打包的扩展。

不需要签名密钥、已打包的扩展、应用商店账户、管理员访问权限或企业策略。manifest.json 中公开的 key 仅用于固定未打包扩展的 ID；它不能对软件进行签名。

4. 连接助手

请使用可执行文件的绝对路径。

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Code 使用相同的可执行文件：

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

传输方式是建立在 stdio 上的换行分隔 JSON-RPC。服务器不监听任何 TCP 端口。

架构

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

一个可执行文件同时扮演 MCP 服务器和 native-host 中继角色。浏览器控制放在 MCP 中，因为它需要可调用的工具、图像结果、加固的 IPC 和持久的会话状态。技能（skill）可以添加工作流，但不能替代服务器。

安全模型

完全的控制是很强大的。Chrome Control MCP 固定扩展来源、限制并验证 IPC、以调用身份验证同用户/同可执行文件的中继、拒绝过期的元素引用和无坐标截图、限制主要负载大小，并暴露严格的 Schema。

Windows 使用 ACL 保护的命名管道。Linux 和 macOS 使用私有运行时目录内的 mode-0600 Unix 套接字，外加操作系统对端凭据，获得额外的保护。

如果只用于检查：

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

只读配置暴露 10 个工具，并独立拒绝要的修改操作。

验证

本地 Windows 和 Linux 门禁当前覆盖：

• 9 个原生和 9 个扩展套件，使用 MSVC、GCC 和 Clang 验证

• warnings-as-errors 且启用 clang-tidy 和全面 cppcheck

• 运行单独的 ASan+UBSan 和 TSan

• 完整历史的 Gitleaks 扫描和 npm 依赖审计

• 43 个 MCP 工具全部在 Windows 上的真实 Chrome 中通过

• 公共 UI Playground 导航、快照、输入、点击和 PNG 捕获

• 可逆的 native-host 安装/状态/卸载生命周期

GitHub Actions 在每次直接推送时都会构建并测试 Windows、Linux 和 macOS。

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

PowerShell 实时公共网站检查：

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

查看精确证据和边界说明。

项目身份

退役本项目时，可用 npm run extension -- uninstall 注销当前用户的 native-host，然后在 chrome://extensions 中手动移除未打包的扩展。

许可证

以 MIT License 发布。版权所有 © 2026 Randy Northrup。