8000 GitHub - zamelee/mcp-chrome: Chrome MCP Server is a Chrome extension-based Model Context Protocol (MCP) server that exposes your Chrome browser functionality to AI assistants like Claude, enabling complex browser automation, content analysis, and semantic search. · GitHub
[go: up one dir, main page]

Skip to content

About

Chrome MCP Server is a Chrome extension-based Model Context Protocol (MCP) server that exposes your Chrome browser functionality to AI assistants like Claude, enabling complex browser automation, content analysis, and semantic search.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

278 Commits

Folders and files

Repository files navigation

Chrome MCP Server

Chrome MCP Server

让 AI 直接操控你的 Chrome 浏览器
基于 Model Context Protocol,向 AI 助手开放 40+ 浏览器能力

License: MIT TypeScript Chrome Extension npm GitHub Release

🇨🇳 中文 · 🇬🇧 English


📢 v1.6.1 更新内容

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 对比

维度 Playwright MCP Chrome 扩展 MCP(本项目)
浏览器进程 需启动独立实例 + 下载二进制 直接使用你现有的 Chrome
登录态 每个站点重新登录 自动继承,即开即用
用户环境 干净配置文件,无扩展无设置 完整用户配置,一切保留
API 能力 限于 Playwright API 完整 Chrome API(标签页/书签/历史/下载)
启动速度 需初始化新浏览器(数秒) 即刻激活(< 1s)
通信延迟 50–200ms 更低延迟,进程内通信

🚀 5 分钟上手

1️⃣ 安装 Chrome 扩展

从 Releases 页面 下载 chrome-mcp-server-*.zip。

打开 chrome://extensions/ → 开启 开发者模式 → 拖入 .zip 安装。

2️⃣ 安装 Native Host

# 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

3️⃣ 启动服务

# 一键启动(推荐)
mcp-chrome-bridge start

# 或克隆仓库后用脚本
start-server.bat

服务将在 http://127.0.0.1:12306/mcp 监听。

4️⃣ 配置客户端

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、点击等待组合

📖 完整 API 参考:中文 · English


📚 使用指南

指南 说明
🤖 智能助手指南 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

About

Chrome MCP Server is a Chrome extension-based Model Context Protocol (MCP) server that exposes your Chrome browser functionality to AI assistants like Claude, enabling complex browser automation, content analysis, and semantic search.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0