GitHub - hangwin/mcp-chrome: Chrome MCP Server - 基于 Chrome 扩展的 Model Context Protocol 服务器
Chrome MCP Server 是一个基于 Chrome 扩展的 Model Context Protocol(MCP)服务器,可将 Chrome 浏览器功能暴露给 Claude 等 AI 助手,实现复杂的浏览器自动化、内容分析和语义搜索。它直接使用用户日常使用的 Chrome 浏览器,保留登录状态和配置,让各种大模型或聊天机器人接管浏览器,成为日常助理。
社区作者 · zZz
它解决什么问题
Chrome MCP Server 是一个基于 Chrome 扩展的 MCP 服务器,它通过 Model Context Protocol 将 Chrome 浏览器的能力暴露给 AI 助手,使 AI 可以直接控制日常使用的 Chrome 浏览器。与传统的 Playwright 等浏览器自动化工具不同,它不需要启动独立浏览器进程,而是直接利用用户已打开的 Chrome,复用用户现有的登录状态、配置和浏览习惯,实现真正的个性化 AI 自动化。
核心功能包括:
- 聊天机器人/模型无关:任何 LLM 或聊天机器人客户端都可以接入并控制浏览器。
- 使用原浏览器:无缝集成现有浏览器环境,保留配置和登录状态。
- 完全本地:纯本地 MCP 服务器,保护用户隐私。
- Streamable HTTP:支持流式 HTTP 连接方式。
- 跨标签页:支持跨标签页上下文。
- 语义搜索:内置向量数据库,可智能发现浏览器标签页内容。
- 智能内容分析:AI 驱动的文本提取和相似度匹配。
- 20+ 工具:支持截图、网络监控、交互操作、书签管理、浏览历史等。
- SIMD 加速 AI:自定义 WebAssembly SIMD 优化,向量运算速度提升 4-8 倍。
项目仍处于早期阶段,正在密集开发中。2025/12/30 新增了针对 Claude Code 与 Codex 的 Visual Editor。项目采用 MIT 许可证。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
前置条件:
- Node.js >= 20.0.0 以及 pnpm/npm
- Chrome/Chromium 浏览器
安装步骤:
- 从 GitHub Releases 下载最新的 Chrome 扩展:https://github.com/hangwin/mcp-chrome/releases
- 全局安装 mcp-chrome-bridge:
npm 方式:npm install -g mcp-chrome-bridgepnpm 方式(方法一,推荐):pnpm config set enable-pre-post-scripts truepnpm install -g mcp-chrome-bridgepnpm 方式(方法二,手动注册,如果 postinstall 未执行):pnpm install -g mcp-chrome-bridgemcp-chrome-bridge register
注意
pnpm v7+ 默认禁用 postinstall 脚本。enable-pre-post-scripts 设置控制 pre/post 安装脚本是否运行。若自动注册失败,请使用上面手动注册命令。- 加载 Chrome 扩展:
- 打开 Chrome,访问 chrome://extensions/
- 启用“开发者模式”
- 点击“加载已解压的扩展程序”,选择下载好的扩展文件夹
- 点击扩展图标打开插件,点击 connect 即可看到 MCP 配置
Streamable HTTP 连接(推荐): 在 MCP 客户端配置(如 CherryStudio)中添加: { "mcpServers": { "chrome-mcp-server": { "type": "streamableHttp", "url": "http://127.0.0.1:12306/mcp" } } } STDIO 连接(备用): 如果客户端仅支持 stdio,请先检查 npm 包安装位置:
- 与 MCP 客户端配合使用:
npm list -g mcp-chrome-bridge或
pnpm list -g mcp-chrome-bridge假设命令输出路径为 /Users/xxx/Library/pnpm/global/5,则最终路径为: /Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.
js 然后在 MCP 客户端配置中添加: { "mcpServers": { "chrome-mcp-stdio": { "command": "npx", "args": [ "node", "/Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js" ] } } }
首次运行:安装扩展并连接后,即可在支持 MCP 的客户端中调用浏览器控制工具。更多工具列表、架构设计和常见问题可参考官方仓库文档。