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 扩展
- 打开 Chrome,访问
chrome://extensions/ - 开启右上角的「开发者模式」
- 点击「加载已解压的扩展程序」
- 选择解压后的文件夹
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. 连接服务
- 点击 Chrome 工具栏中的 Chrome MCP 扩展图标
- 点击「连接端口」按钮
- 状态变为绿色「服务已启动」即表示成功
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
连接失败
- 确保 Chrome 扩展已启用
- 确保点击了「连接端口」按钮
- 检查端口 12306 是否被占用
- 重启 Chrome 和 AI 工具
更换端口
如果 12306 端口被占用:
mcp-chrome-bridge update-port 12307
然后更新 MCP 配置中的端口号。
参考链接
- GitHub: https://github.com/nicholasxuu/mcp-chrome
- NPM: https://www.npmjs.com/package/mcp-chrome-bridge
创建时间:2025-12-29