Repository navigation
开发更新：mcp-chrome-2026 的新增功能与稳定性改进 #370
Description
🚀 mcp-chrome-2026：面向真实 Chrome 环境的 MCP 浏览器控制 / MCP Browser Control for Your Real Chrome
📦 项目地址：phoenixlucky/mcp-chrome-2026
📖 简介 / Introduction
中文：这是一个基于 Chrome 扩展 + Native Host 的 MCP（Model Context Protocol）浏览器控制方案。与 Playwright/Selenium 等传统方案不同，它直接接入你正在使用的 Chrome 浏览器，天然保留：
- ✅ 已有的登录状态和 Session
- ✅ 浏览器 Cookie 和本地存储
- ✅ 已安装的扩展和用户设置
无需启动独立浏览器进程，无需重复登录。
English: An MCP (Model Context Protocol) browser-control solution built on a Chrome extension + Native Host. Unlike traditional approaches such as Playwright/Selenium, it connects directly to the Chrome browser you are already using, naturally preserving:
- ✅ Existing login state and sessions
- ✅ Browser cookies and local storage
- ✅ Installed extensions and user settings
No separate browser process, no repeated logins.
🎯 能做什么 / What It Can Do
| 能力 / Capability | 说明 / Description |
|---|---|
| 🪟 窗口与标签页管理 / Windows & tabs | 新建、关闭、切换窗口/标签页，导航控制 / create, close, switch windows/tabs, navigation control |
| 📸 截图 / Screenshots | 页面截图、元素截图、全页截图 / page, element, and full-page screenshots |
| 📝 内容提取 / Content extraction | 提取页面文本/HTML，Readability 文章提取 / extract page text/HTML, Readability article extraction |
| 🧩 结构化数据采集 / Structured data | 通过 CSS 选择器批量提取结构化数据 / batch extract structured data via CSS selectors |
| 🖱️ 页面交互 / Page interaction | 点击、表单填充、键盘输入、滚动 / click, form fill, keyboard input, scroll |
| 🌐 网络监控 / Network monitoring | 捕获网络请求与响应 / capture network requests & responses |
| 🔍 语义搜索 / Semantic search | 跨标签页向量语义搜索 / cross-tab vector semantic search |
| 📚 书签与历史管理 / Bookmarks & history | 查询、添加、删除书签和浏览历史 / query, add, delete bookmarks & browsing history |
所有能力通过 MCP 协议 暴露，可供 Claude、Cursor、VS Code 扩展、Cherry Studio 等任何 MCP 兼容客户端调用。/ All capabilities are exposed via the MCP protocol and can be called by any MCP-compatible client: Claude, Cursor, VS Code extensions, Cherry Studio, etc.
✨ 近期更新（v2.0.0）/ What's New (v2.0.0)
| 改进项 / Improvement | 描述 / Description |
|---|---|
| 🔒 CDP 会话管理重构 / CDP session rework | 每个 tab 的 attach / detach / sendCommand 增加 per-tab 串行锁，杜绝并发会话冲突；owner 改为引用计数 Map，修复会话泄漏 / per-tab serial locks for attach / detach / sendCommand eliminate concurrent session races; owners now use reference counting (Set → Map) to fix session leaks |
| 🛑 chrome_javascript 取消支持 / Cancellation support | 工具执行接入 AbortSignal，超时/取消后主动 detach 残留 debugger 会话，防止连锁卡住；错误契约新增 cancelled 种类 / tools honor AbortSignal — stale debugger sessions are detached on timeout/cancel to prevent cascading hangs; new cancelled error kind |
| ✅ 回归测试 / Regression tests | 新增 cdp-session-manager.test.ts 与 chrome_javascript 取消契约测试 / new cdp-session-manager.test.ts and chrome_javascript cancellation contract tests |
| 🔧 版本统一 / Version bump | 版本统一为 v2.0.0 / all packages bumped to v2.0.0 |
💡 适合的场景 / Ideal Use Cases
需要让 AI 在你的已有登录态下 完成以下工作时，这个方案比独立浏览器自动化更贴近真实使用环境。/ Get AI working under your existing login state — closer to real-world usage than standalone browser automation:
- 📊 网页数据采集 / Web data collection — 登录后的后台页面、需要 Session 的 API 数据 / logged-in dashboards, API data that requires a session
- 🔄 重复性浏览器操作 / Repetitive operations — 表单填写、批量操作、定时任务 / form filling, batch operations, scheduled tasks
- 📋 内容分析与总结 / Content analysis — 提取文章、对比多个页面内容 / extracting articles, comparing content across pages
- 🐞 调试与排查 / Debugging — 捕获网络请求、检查控制台输出 / capturing network requests, inspecting console output
🚀 快速开始 / Quick Start
# 1. 安装 Native Host / Install Native Host
npm install -g @ethanwilkins/mcp-chrome-bridge-2026
# 2. 下载并加载 Chrome 扩展 / Download & load the Chrome extension
# 从 Releases 下载最新版，解压后在 chrome://extensions/ 中加载
# Download the latest release, unzip, then load in chrome://extensions/
# 3. 启动服务 / Start the service
start-server.bat # 或：mcp-chrome-bridge start / or: mcp-chrome-bridge start配置 MCP 客户端：/ Configure your MCP client:
{
"mcpServers": {
"chrome-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:12306/mcp"
}
}
}📚 更多资源 / More Resources
欢迎试用，也欢迎提交 Issue 或 PR 交流改进建议！ 🙌 / Welcome to try it out — Issues and PRs are welcome!
Activity
[-]介绍：mcp-chrome-2026 —— 基于 Chrome 扩展的 MCP 浏览器控制方案[/-][+]项目更新与改进：mcp-chrome-2026[/+][-]项目更新与改进：mcp-chrome-2026[/-][+]开发更新：mcp-chrome-2026 的新增功能与稳定性改进[/+]docs: 同步 issue hangwin#370 项目介绍至 v2.0.0 README（中英双语）Add bilingual pro…
docs: sync issue hangwin#370 project intro to v2.0.0 README_en (bilin…