Chrome Mcp Server

Name: Chrome Mcp Server
Author: hangwin

远程服务

github.com/hangwin浏览器自动化12.5k42 周前更新

代码仓库

关于 Chrome Mcp Server

Chrome MCP Server 是一个基于 Chrome 扩展的 MCP 服务，将用户日常使用的 Chrome 浏览器功能暴露给 AI 助手。与基于 Playwright 的方案不同，它直接复用用户已打开的浏览器、配置和登录状态，完全本地运行。

主要功能

01复用用户现有 Chrome 环境与登录状态
02支持 Streamable HTTP 与 STDIO 连接
03提供 20 余种浏览器工具
04内置向量数据库，支持标签页内容语义搜索
05提供截图、网络监控与书签、历史记录管理

适用场景

01让 AI 助手总结当前网页内容并辅助绘图
02分析网络请求以查找接口及响应结构
03按时间或关键词分析浏览历史与管理书签

MCP 相关

该项目是 MCP 服务，通过 Chrome 扩展和 mcp-chrome-bridge 向 Claude 等 MCP 客户端暴露浏览器工具与能力。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址http://172.19.176.1:12306/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http chrome http://172.19.176.1:12306/mcp

Cursor.cursor/mcp.json{"mcpServers":{"chrome":{"type":"http","url":"http://172.19.176.1:12306/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"chrome":{"type":"http","url":"http://172.19.176.1:12306/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"chrome":{"type":"http","url":"http://172.19.176.1:12306/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"chrome":{"serverUrl":"http://172.19.176.1:12306/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Chrome MCP 服务 🚀

🌟 将你的 Chrome 浏览器变成智能助手 - 让 AI 接管你的浏览器，将其转变为强大的 AI 控制自动化工具。

📖 文档：English | 中文

项目仍处于早期阶段，正在密集开发中。后续将推出更多功能、稳定性改进及其他增强。

🎯 什么是 Chrome MCP 服务？

Chrome MCP 服务是一个基于 Chrome 扩展的 Model Context Protocol（MCP）服务，可将 Chrome 浏览器的功能提供给 Claude 等 AI 助手，以实现复杂的浏览器自动化、内容分析和语义搜索。与传统的浏览器自动化工具（如 Playwright）不同，Chrome MCP 服务直接使用你日常使用的 Chrome 浏览器，利用现有的使用习惯、配置和登录状态，让各种大模型或聊天机器人接管你的浏览器，真正成为你的日常助手。

✨ 新功能（2025/12/30）

为 Claude Code 和 Codex 提供全新的可视化编辑器，详情请见：VisualEditor

✨ 核心功能

😁 不受聊天机器人/模型限制：让你偏好的任何 LLM、聊天机器人客户端或 Agent 自动化浏览器
⭐️ 使用你的原有浏览器：与你现有的浏览器环境（配置、登录状态等）无缝集成
💻 完全本地运行：纯本地 MCP 服务，确保用户隐私
🚄 可流式传输的 HTTP：可流式传输的 HTTP 连接方式
🏎 跨标签页：跨标签页上下文
🧠 语义搜索：内置向量数据库，可智能发现浏览器标签页内容
🔍 智能内容分析：由 AI 驱动的文本提取和相似度匹配
🌐 20 多种工具：支持屏幕截图、网络监控、交互操作、书签管理、浏览历史记录以及其他 20 多种工具
🚀 SIMD 加速 AI：自定义 WebAssembly SIMD 优化，使向量运算速度提升 4–8 倍

🆚 与类似项目的比较

比较维度	基于 Playwright 的 MCP 服务	基于 Chrome 扩展的 MCP 服务
资源使用	❌ 需要启动独立的浏览器进程、安装 Playwright 依赖、下载浏览器二进制文件等。	✅ 无需启动独立的浏览器进程，可直接使用用户已打开的 Chrome 浏览器
用户会话复用	❌ 需要重新登录	✅ 自动使用现有登录状态
浏览器环境	❌ 独立环境中没有用户设置	✅ 完整保留用户环境
API 访问	⚠️ 仅限于 Playwright API	✅ 可完整访问 Chrome 原生 API
启动速度	❌ 需要启动浏览器进程	✅ 只需激活扩展
响应速度	进程间通信需要 50-200ms	✅ 更快

🚀 快速开始

前提条件

Node.js >= 20.0.0 和 pnpm/npm
Chrome/Chromium 浏览器

安装步骤

从 GitHub 下载最新的 Chrome 扩展

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

全局安装 mcp-chrome-bridge

npm

npm install -g mcp-chrome-bridge

pnpm

# Method 1: Enable scripts globally (recommended)
pnpm config set enable-pre-post-scripts true
pnpm install -g mcp-chrome-bridge

# Method 2: Manual registration (if postinstall doesn't run)
pnpm install -g mcp-chrome-bridge
mcp-chrome-bridge register

注意：pnpm v7+ 出于安全考虑默认禁用 postinstall 脚本。enable-pre-post-scripts 设置用于控制是否运行 pre/post 安装脚本。如果自动注册失败，请使用上面的手动注册命令。

加载 Chrome 扩展
- 打开 Chrome 并访问 chrome://extensions/
- 启用“开发者模式”
- 点击“加载已解压的扩展程序”，并选择 your/dowloaded/extension/folder
- 点击扩展图标打开插件，然后点击连接以查看 MCP 配置

在 MCP 协议客户端中使用

使用 Streamable HTTP 连接（👍🏻 推荐）

将以下配置添加到 MCP 客户端配置中（以 CherryStudio 为例）：

推荐使用 Streamable HTTP 连接方式

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

使用 STDIO 连接（备选）

如果你的客户端仅支持 stdio 连接方式，请按以下步骤操作：

首先，检查刚安装的 npm 包的位置

# npm check method
npm list -g mcp-chrome-bridge
# pnpm check method
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

将下方配置中的路径替换为刚刚获取的最终路径

{
  "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"
      ]
    }
  }
}

例如：augment 中的配置：