Chrome MCP 配置教程

Chrome MCP 是一个强大的浏览器自动化工具,可以让 AI 助手直接控制 Chrome 浏览器,实现网页抓取、自动化操作、截图等功能。

功能特性

  • 🌐 浏览器控制:导航、前进后退、标签页管理
  • 📄 内容获取:抓取网页文本、HTML、交互元素
  • 🖱️ 自动化操作:点击、填表、键盘输入
  • 📸 截图:全页面或指定元素截图
  • 🔍 搜索:浏览历史、书签搜索
  • 🌐 网络:捕获网络请求、发送请求
  • 🧠 语义搜索:基于 AI 的标签页内容搜索

安装步骤

1. 下载 Chrome 扩展

访问 GitHub Releases 页面下载最新版本:
https://github.com/nicholasxuu/mcp-chrome/releases

下载 chrome-mcp-server-x.x.x.zip 文件并解压。

2. 安装 Chrome 扩展

  1. 打开 Chrome,访问 chrome://extensions/
  2. 开启右上角的「开发者模式」
  3. 点击「加载已解压的扩展程序」
  4. 选择解压后的文件夹

3. 安装 Native Bridge

在终端运行:

npm install -g mcp-chrome-bridge

4. 注册 Native Messaging Host

mcp-chrome-bridge register

成功后会显示:

Successfully registered user-level Native Messaging host!

5. 连接服务

  1. 点击 Chrome 工具栏中的 Chrome MCP 扩展图标
  2. 点击「连接端口」按钮
  3. 状态变为绿色「服务已启动」即表示成功

MCP 配置

在 Kiro/Cursor/Claude 等工具中添加配置:

{
  "mcpServers": {
    "streamable-mcp-server": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

常用工具

工具 功能
get_windows_and_tabs 获取所有窗口和标签页
chrome_navigate 导航到指定 URL
chrome_get_web_content 获取网页内容
chrome_click_element 点击元素
chrome_fill_or_select 填写表单
chrome_screenshot 截图
chrome_history 搜索浏览历史
chrome_bookmark_search 搜索书签
search_tabs_content 语义搜索标签页内容

语义搜索功能

Chrome MCP 内置了 AI 语义搜索引擎,支持两种 Embedding 模型:

  • multilingual-e5-small:轻量级,116MB,384维
  • multilingual-e5-base:效果更好,279MB,768维

可以在扩展设置中切换模型。

故障排除

显示「已连接,服务未启动」

说明 Native Bridge 没有正确注册,重新运行:

mcp-chrome-bridge register

连接失败

  1. 确保 Chrome 扩展已启用
  2. 确保点击了「连接端口」按钮
  3. 检查端口 12306 是否被占用
  4. 重启 Chrome 和 AI 工具

更换端口

如果 12306 端口被占用:

mcp-chrome-bridge update-port 12307

然后更新 MCP 配置中的端口号。

参考链接


创建时间:2025-12-29

写文章用