MCP Chrome

这是什么？

MCP Chrome 是一个 Chrome 扩展 MCP 服务器，将浏览器完整暴露给 AI Agent 控制。GitHub hangwin/mcp-chrome，12.3k Stars，MIT 许可证。

核心价值：Agent 可以像人类一样浏览网页——点击按钮、填写表单、提取数据、截图。适合 Web 自动化测试、数据采集、表单自动填写等场景。

适合谁：需要 Web 自动化的开发者、QA 测试工程师、数据采集工程师。

前置条件：Chrome 浏览器，Node.js 18+，支持 MCP 的 AI 编程客户端。

准备工作

安装

git clone https://github.com/hangwin/mcp-chrome.git
cd mcp-chrome
npm install
npm run build

配置

在 Claude Code 的 MCP 配置中添加：

{
  "mcpServers": {
    "chrome": {
      "command": "node",
      "args": ["path/to/mcp-chrome/dist/index.js"],
      "env": {
        "CHROME_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
      }
    }
  }
}

时间预算：安装 5 分钟，第一个自动化任务 10 分钟。

三步上手

第一步：启动 Chrome 调试模式

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

第二步：让 Agent 浏览网页

在 Claude Code 中：

“打开 https://github.com/trending，提取今天的 Top 10 项目名称和 Stars”

第三步：自动化表单填写

“打开 https://example.com/form，填写姓名、邮箱、留言，然后截图确认”

常见踩坑

踩坑 1：Chrome 调试端口被占用

症状：启动时报 “address already in use”。

原因：已有 Chrome 实例占用了 9222 端口。

解决：关闭所有 Chrome 窗口后重新启动，或使用 --remote-debugging-port=9223。

踩坑 2：页面加载未完成就操作

症状：点击操作报 “element not found”。

原因：Agent 在页面 DOM 完全渲染前就开始操作。

解决：使用 waitForSelector 等待目标元素出现，或设置 --wait-timeout 5000。

踩坑 3：登录态丢失

症状：Agent 操作需要登录的页面时被重定向到登录页。

原因：Chrome 调试模式默认使用全新 Profile。

解决：使用 --user-data-dir=/path/to/your/chrome/profile 保持登录态。

踩坑 4：验证码页面卡住

症状：Agent 遇到验证码时无限等待。

原因：AI Agent 无法自动处理图片验证码。

解决：配置 --captcha-mode manual，Agent 遇到验证码时暂停并通知用户。

踩坑 5：headless 模式与普通模式行为差异

症状：headless 模式下某些元素不渲染。

原因：部分网站检测 headless 模式并返回不同内容。

解决：使用 --headless=new（新版 headless 模式）或添加 --user-agent 伪装。

FAQ

Q1: MCP Chrome 是否免费？

A: 完全开源（MIT 许可证），免费使用。

Q2: 支持哪些浏览器？

A: 主要支持 Chrome/Chromium。Firefox 通过 --browser firefox 实验性支持。

Q3: 与 Puppeteer/Playwright 有什么区别？

A: Puppeteer/Playwright 需要编写代码，MCP Chrome 让 Agent 用自然语言操控浏览器。

Q4: 能否同时控制多个浏览器标签？

A: 支持。Agent 可以打开多个标签页并独立操作每个标签。

Q5: 数据安全如何保障？

A: 所有操作在本地 Chrome 实例中执行，数据不离开你的机器。

参考链接

• 官方 GitHub
• Chrome DevTools Protocol

本文基于公开资料整理，AI 辅助生成，数据截至 2026-08-05。具体功能请以官方文档为准。