让 AI 直接操控你的 Chrome 浏览器
基于 Model Context Protocol,向 AI 助手开放 40+ 浏览器能力
output-sanitizer 精简 — 移除冗余分支逻辑,新增单元测试覆盖。
- 🧹 代码精简 — 移除
sanitizeOutput中的冗余分支,简化代码结构- ✅ 新增测试 —
output-sanitizer.test.ts覆盖核心路径- 🔧 所有包版本统一为 v1.6.1
查看 完整更新日志 了解所有版本变更。
| 🤖 AI 原生控制 Claude / Cursor / VS Code 直接操控浏览器 |
🔐 零配置即用 复用现有 Chrome 登录态 / Cookie 即刻继承 |
🛡️ 纯本地运行 数据不出环境 隐私安全有保障 |
🚄 Streamable HTTP 实时流式响应 现代 MCP 传输协议 |
| 🧠 语义搜索 向量数据库 + 本地嵌入 跨标签页内容发现 |
⚡ SIMD 加速 WASM 优化引擎 向量运算 4-8× 更快 |
📊 40+ 工具 导航 / 截图 / 表单 书签 / 历史 / 网络 |
🔄 跨标签页操作 多标签 / 多窗口 无缝协同管理 |
| 维度 | Playwright MCP | Chrome 扩展 MCP(本项目) |
|---|---|---|
| 浏览器进程 | 需启动独立实例 + 下载二进制 | 直接使用你现有的 Chrome |
| 登录态 | 每个站点重新登录 | 自动继承,即开即用 |
| 用户环境 | 干净配置文件,无扩展无设置 | 完整用户配置,一切保留 |
| API 能力 | 限于 Playwright API | 完整 Chrome API(标签页/书签/历史/下载) |
| 启动速度 | 需初始化新浏览器(数秒) | 即刻激活(< 1s) |
| 通信延迟 | 50–200ms | 更低延迟,进程内通信 |
从 Releases 页面 下载 chrome-mcp-server-*.zip。
打开 chrome://extensions/ → 开启 开发者模式 → 拖入 .zip 安装。
# npm(推荐,自动注册)
npm install -g @ethanwilkins/mcp-chrome-bridge-2026
# pnpm
pnpm install -g @ethanwilkins/mcp-chrome-bridge-2026
postinstall自动注册 Native Messaging Host。如需手动注册:mcp-chrome-bridge register
# 一键启动(推荐)
mcp-chrome-bridge start
# 或克隆仓库后用脚本
start-server.bat服务将在 http://127.0.0.1:12306/mcp 监听。
Streamable HTTP(推荐)
{
"mcpServers": {
"chrome-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:12306/mcp"
}
}
}STDIO(备选)
{
"mcpServers": {
"chrome-mcp-stdio": {
"command": "node",
"args": ["/path/to/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js"]
}
}
}| 分类 | 数量 | 覆盖能力 |
|---|---|---|
| 🖥️ 浏览器管理 | 7 | 窗口/标签页列表、导航、切换、关闭、前进后退、脚本注入 |
| 📷 截图 | 1 | 元素级、全页面、自定义视口 |
| 🌐 网络监控 | 4 | 请求捕获(webRequest / CDP)、自定义 HTTP |
| 📝 内容分析 | 4 | 语义搜索、HTML / 文本提取、交互元素检测、控制台日志 |
| 🖱️ 交互操作 | 3 | 点击、表单填充、键盘输入 |
| 📑 数据管理 | 4 | 历史搜索、书签增删查 |
| 📡 采集提取 | 6+ | 滚动、等待、结构化提取、Readability、点击等待组合 |
| 指南 | 说明 |
|---|---|
| 🤖 智能助手指南 | Claude / Codex / DeepSeek 会话与 API 配置 |
| ⚡ 快捷工具指南 | 页面 Quick Panel 和插件弹窗 MCP 工具目录 |
| 场景 | 操作 | 演示 |
|---|---|---|
| 📄 AI 总结 + Excalidraw 可视化 | 总结页面内容并画图 | 视频 |
| 🖼️ 图片分析 + Excalidraw 复现 | 分析图片内容并重建 | 视频 |
| 🎨 样式注入与网页修改 | 修改页面样式去广告 | 视频 |
| 📡 网络请求捕获分析 | 查找 API 端点与响应结构 | 视频 |
| 📊 浏览历史分析 | 分析近一个月浏览记录 | 视频 |
| 💬 网页对话 | 翻译并总结当前页面 | 视频 |
| 📸 页面与元素截图 | 截取首页 / 捕获图标 | 视频 1 · 视频 2 |
| 🔖 书签管理 | 将当前页添加到书签 | 视频 |
| 🗑️ 批量关闭标签页 | 关闭匹配关键词的标签页 | 视频 |
| ✅ 已实现 | 🎯 规划中 |
|---|---|
| 40+ MCP 工具 — 浏览器全能力覆盖 | 认证与权限管理 — API Key / OAuth 接入 |
| Streamable HTTP + STDIO 双传输 | 工具级 ACL — 精细控制每个客户端的工具权限 |
| 智能助手 — Claude / Codex / DeepSeek | 实时监控仪表盘 — Web 面板查看调用、性能、错误 |
| 语义搜索 — 向量数据库 + 本地嵌入 | 跨平台安装体验 — macOS / Linux 一键脚本 |
| SIMD 加速 — WASM 引擎 4-8× 更快 | |
| 工作流录制与回放 — v3 统一架构(v2 已完全迁移) | |
| 可视化编辑器 — 拖拽搭建工作流 | |
| Native Messaging 自动注册 |
欢迎贡献!提交 PR 前请阅读 CONTRIBUTING_zh.md。
MIT — 详见 LICENSE 文件。
| 文档 | 链接 |
|---|---|
| 🏗️ 架构设计 | ARCHITECTURE_zh.md |
| 🔧 工具 API 参考 | TOOLS_zh.md |
| 🤖 智能助手指南 | SMART_ASSISTANT_zh.md |
| ⚡ 快捷工具指南 | QUICK_TOOLS_zh.md |
| 🔍 故障排除 | TROUBLESHOOTING_zh.md |
| 📋 更新日志 | CHANGELOG.md |