ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Chrome MCP Server 完整指南:把浏览器能力完整暴露给 AI

Chrome MCP Server 完整指南:把浏览器能力完整暴露给 AI

Chrome MCP Server 完整指南:把浏览器能力完整暴露给 AI

【免费下载链接】mcp-chromeChrome 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.项目地址: https://gitcode.com/gh_mirrors/mc/mcp-chrome

Chrome MCP Server 是一个基于 Chrome 扩展的 MCP 服务器:它把你日常使用的 Chrome 的标签页、页面内容和原生 API 暴露给 AI 助手,让 Claude 等客户端能直接替你导航、点击、读取页面,而不需要再养一个无头浏览器。

为什么让 AI 操作浏览器时你总要"手动补位"

如果你试过让 AI 干浏览器的活,大概率经历过这条链路:起一个 Playwright 或 WebDriver 环境,装依赖、下载浏览器二进制;打开之后是全新会话,各站点要重新登录一次;任务跑完环境就闲置,下次登录态又没了。模型再强,也卡在"干净浏览器里没有账号"这一步,你只能在旁边手动登录、手动复制结果。

一句话定位:Chrome MCP Server 是以 Chrome 扩展形态运行的 MCP 服务器,把现有浏览器直接接入 AI 客户端,适合想在本机 AI 客户端里完成内容处理、表单填写、页面操作,又不想维护第二套浏览器环境的人。

它凭什么不一样:省掉独立浏览器、省掉重新登录

  • 省掉独立浏览器进程:不用装 Playwright 依赖和浏览器二进制,AI 直接操作你已经打开的 Chrome,省安装、省一份常驻内存。
  • 省掉重新登录:复用你现有的登录态,你登录过的站点,AI 进去就是登录状态。
  • 省掉第三方中转:MCP 服务器完全在本地运行,页面内容和操作指令不经外部服务。
  • 多得到一套工具面:截图、网络捕获、控制台读取、书签与历史管理、脚本注入、跨标签页上下文等 20 多个工具都向 AI 开放;语义搜索还能让它按内容找到"某个标签页里有什么"。

3 步装好扩展并接上 MCP 客户端

前置条件:Node.js >= 20.0.0、npm 或 pnpm、Chrome/Chromium。

第 1 步:拿到扩展。直接用项目 releases/chrome-extension/ 目录下的最新预构建包最省事;想从源码构建就执行:

git clone https://gitcode.com/gh_mirrors/mc/mcp-chrome cd mcp-chrome && pnpm install cd app/chrome-extension && pnpm run build

这几条命令克隆仓库、安装依赖并构建扩展,产物在app/chrome-extension/dist,后面就是浏览器要加载的目录。

第 2 步:装本地桥接服务。

npm install -g mcp-chrome-bridge

它全局安装本地 MCP 服务并尝试自动注册 native messaging 主机;如果用的是 pnpm v7+(默认不跑 postinstall 脚本)且自动注册没生效,手动补一条mcp-chrome-bridge register。

第 3 步:加载扩展并连接。打开chrome://extensions/,打开"开发者模式",点"加载已解压的扩展程序"选中扩展目录;再点扩展图标打开插件面板,点击连接。MCP 客户端那边,在配置里加一个streamableHttp类型的服务器,地址填http://127.0.0.1:12306/mcp即可,不用手写整段 JSON。连不上时先翻 docs/TROUBLESHOOTING.md。

接好之后,你可以这样用 4 个高频场景

  • 让它替你读长文档:取当前页正文并输出摘要;项目把现成的 Excalidraw 画图 prompt 放在 prompt/excalidraw-prompt.md,边读边画结构图。
  • 让它填表单、点按钮:AI 先定位输入框和提交按钮,再逐项填写提交,适合重复性的注册、录入操作。
  • 让它抓页面网络请求:开启网络捕获,问一句"这个站点的搜索接口是什么、响应结构长什么样",比手动翻 F12 快。
  • 让它整理书签和历史:把当前页归档到合适的文件夹,或让它分析最近一个月的浏览记录,给你一份归类清单。

完整工具清单见 docs/TOOLS.md。

与 Playwright 类方案横向对比

维度Playwright 类 MCPChrome MCP Server
浏览器进程要拉起独立浏览器并装依赖、二进制直接复用已打开的 Chrome
登录态干净环境需重新登录复用你现有会话
API 面受限于 Playwright API可访问 Chrome 原生 API
启动成本先启动浏览器进程激活扩展并连接即可

当前局限与演进方向

先说实话:项目自述仍处早期阶段。从源码构建的扩展走的是"开发者模式 + 未打包加载",不是商店里的永久安装;连接依赖本地桥接服务,换机器或重装系统后要重新注册。路线图里还有认证机制、录制回放、工作流自动化和 Firefox 支持几项,落地前建议把它当"高级玩家工具"用。想深挖内部结构可以读 docs/ARCHITECTURE.md。

你的第一次自动化:今天就能跑通的一步

扩展加载成功后,在 AI 客户端里发一句:"打开当前标签页,总结页面内容,并列出其中可点击的元素"。能收到带摘要的回复,说明链路已通,接下来就可以把真实任务交给它。

【免费下载链接】mcp-chromeChrome 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.项目地址: https://gitcode.com/gh_mirrors/mc/mcp-chrome

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进