项目概述

Chrome MCP Server是一个革命性的浏览器自动化工具,它将你的Chrome浏览器转变为AI助手的智能操作平台

⚠️ 重要说明
这不是Chrome官方项目:Chrome MCP Server是由开发者hangwin创建的第三方开源项目,并非Google Chrome官方出品。它是一个基于Chrome扩展API的独立工具。

Chrome MCP Server通过Chrome扩展的形式,将浏览器功能暴露给AI助手,实现了前所未有的浏览器自动化体验。与传统的Playwright等工具不同,它直接使用你日常的Chrome浏览器,保留所有的用户配置、登录状态和个人设置,让AI真正成为你的日常助手。

核心特性

强大的功能集合,让AI能够完全控制你的浏览器

🤖

AI模型无关

支持任何LLM或聊天机器人客户端,让你喜欢的AI助手都能自动化你的浏览器操作。

🌐

使用原生浏览器

无缝集成现有浏览器环境,保留所有配置、登录状态和个人设置,无需重新配置。

🔒

完全本地化

纯本地MCP服务器,确保用户隐私安全,所有操作都在本地执行。

流式HTTP连接

支持流式HTTP连接方式,提供更快的响应速度和更稳定的连接。

🔄

跨标签页操作

支持跨标签页上下文操作,能够在多个网页间进行复杂的自动化任务。

🧠

语义搜索

内置向量数据库,支持智能的浏览器标签页内容发现和语义搜索功能。

🔍

智能内容分析

AI驱动的文本提取和相似性匹配,能够智能分析网页内容并提取关键信息。

🛠️

20+工具集

支持截图、网络监控、交互操作、书签管理、浏览历史等20多种强大工具。

🚄

SIMD加速AI

自定义WebAssembly SIMD优化,向量操作速度提升4-8倍,性能卓越。

优势对比

相比传统Playwright等工具的显著优势

对比维度 Playwright等工具 Chrome MCP Server
资源使用 ❌ 需要启动独立浏览器进程 ✅ 直接使用已打开的Chrome
用户会话 ❌ 需要重新登录 ✅ 自动使用现有登录状态
浏览器环境 ❌ 干净环境缺少用户设置 ✅ 完全保留用户环境
启动速度 ❌ 需要启动浏览器进程 ✅ 只需激活扩展
响应速度 ⚠️ 50-200ms进程间通信 ✅ 更快的响应速度

安装指南

简单几步,让AI接管你的浏览器

1 下载Chrome扩展

从GitHub Releases页面下载最新版本的Chrome扩展文件。

下载链接
https://github.com/hangwin/mcp-chrome/releases

2 安装mcp-chrome-bridge

全局安装mcp-chrome-bridge包,这是连接Chrome扩展和MCP协议的桥梁。

💡 注册说明:
  • npm用户:安装后自动注册,无需手动操作
  • pnpm用户:需要启用脚本或手动注册
npm
# 使用npm安装(自动注册)
npm install -g mcp-chrome-bridge

# 使用pnpm安装
# 方法1:启用脚本后安装(推荐)
pnpm config set enable-pre-post-scripts true
pnpm install -g mcp-chrome-bridge

# 方法2:安装后手动注册
pnpm install -g mcp-chrome-bridge
mcp-chrome-bridge register

3 加载Chrome扩展

在Chrome浏览器中加载下载的扩展文件。

  1. 打开Chrome浏览器,访问 chrome://extensions/
  2. 启用"开发者模式"
  3. 点击"加载已解压的扩展程序"
  4. 选择下载的扩展文件夹
  5. 点击扩展图标,然后点击"连接"查看MCP配置

配置使用

在你的MCP客户端中配置Chrome MCP Server

🌊 流式HTTP连接(推荐)

推荐使用流式HTTP连接方式,性能更好,配置更简单。

JSON配置
{
  "mcpServers": {
    "chrome-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

📡 STDIO连接(备选)

如果你的客户端只支持stdio连接方式,可以使用以下配置。

JSON配置
{
  "mcpServers": {
    "chrome-mcp-stdio": {
      "command": "npx",
      "args": [
        "node",
        "/path/to/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js"
      ]
    }
  }
}

⚠️ 注意:需要将路径替换为你实际的安装路径,可通过 npm list -g mcp-chrome-bridge 查看。

功能工具

20+强大工具,覆盖浏览器操作的方方面面

🖥️

浏览器管理 (6个工具)

  • • 列出所有窗口和标签页
  • • 导航到URL并控制视口
  • • 关闭特定标签页或窗口
  • • 浏览器前进后退控制
  • • 注入内容脚本到网页
  • • 向注入脚本发送命令
📸

截图与视觉 (1个工具)

  • • 高级截图捕获
  • • 元素定位截图
  • • 全页面截图支持
  • • 自定义尺寸截图
🌐

网络监控 (4个工具)

  • • webRequest API网络捕获
  • • 调试器API响应体获取
  • • 发送自定义HTTP请求
  • • 网络请求分析
🔍

内容分析 (4个工具)

  • • AI驱动的语义搜索
  • • 提取HTML/文本内容
  • • 查找可点击元素
  • • 捕获控制台输出
🎯

交互操作 (3个工具)

  • • CSS选择器点击元素
  • • 填写表单和选择选项
  • • 模拟键盘输入和快捷键
📚

数据管理 (5个工具)

  • • 搜索浏览器历史记录
  • • 按关键词查找书签
  • • 添加新书签到文件夹
  • • 删除书签
  • • 时间过滤器支持

使用示例

看看AI如何智能地控制你的浏览器

📝 智能内容总结与绘图

AI帮助你总结网页内容,然后自动控制Excalidraw进行绘图辅助理解。

提示词: "帮我总结当前页面内容,然后画一个图表来辅助我理解。"

🎨 自动样式修改

AI自动注入脚本并修改网页样式,比如移除广告、调整布局等。

提示词: "帮我修改当前页面的样式,移除广告。"

🔍 网络请求分析

AI自动捕获网络请求,分析API结构和响应数据。

提示词: "我想知道小红书的搜索API是什么,响应结构是怎样的。"

📊 浏览历史分析

AI帮助分析你的浏览历史,发现浏览模式和兴趣偏好。

提示词: "分析我过去一个月的浏览历史。"

技术架构

了解Chrome MCP Server的技术实现

🏗️ 架构组件

  • • Chrome扩展前端
  • • MCP协议桥接器
  • • 向量数据库引擎
  • • WebAssembly SIMD优化

💻 技术栈

  • • TypeScript (57.9%)
  • • JavaScript (31.5%)
  • • Vue.js (7.7%)
  • • Rust (1.0%)

🔧 核心API

  • • Chrome Extensions API
  • • Model Context Protocol
  • • WebRequest API
  • • Debugger API

社区支持

加入活跃的开发者社区,获取帮助和分享经验

📦

GitHub仓库

查看源码、提交问题、参与开发

访问GitHub
📚

完整文档

详细的API文档和使用指南

查看文档
🐛

问题反馈

遇到问题?提交Issue获取帮助

提交问题

🚀 项目统计

8.1k
GitHub Stars
685
Forks
37
Watchers
MIT
开源协议