mcp-chrome-bridge 完整安装指南3 条命令装好 Native Messaging 主机扩展即连本地服务【免费下载链接】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装好 mcp-chrome-bridge 之后你的 Chrome 扩展立刻能通过 Native Messaging 主机和本机 Node 服务双向通信在扩展里点一下 Connect浏览器就自动拉起一个本地进程替你处理 MCP 请求、读写本地 SQLite、驱动浏览器自动化。它就是浏览器扩展本地通信的桥这篇文章带你从零把这座桥架起来。⚡ 快速上手3 条命令装好并注册前提只有一个Node.js 20 或以上node -v确认主版本 ≥ 20。然后打开终端按顺序敲npm install -g mcp-chrome-bridge mcp-chrome-bridge register mcp-chrome-bridge doctor第 1 条装包。postinstall 钩子会先给 run_host 脚本、index.js、cli.js 三个文件补 755 执行权限再自动尝试用户级注册——大多数机器到这一步就已注册成功所以注册不需要管理员权限。第 2 条手动补注册。它做两件事把当前 Node 可执行文件的绝对路径写进 node_path.txt再把 manifest 清单文件写进系统对应目录。为什么锁定 Node 路径因为主机依赖 better-sqlite3 这类原生模块对 Node ABI 版本敏感后面机制一节会展开。第 3 条体检。doctor 逐项检查清单文件、执行权限、Node 版本、端口 12306 的连通性每项给出 OK / WARN / ERROR看到 ERROR 就直接加--fix重跑它会自动修权限、重建日志目录并重新注册。注册前它会先探测你装了哪些浏览器Windows 查注册表macOS 看 /Applications/Linux 用 which探测不到时默认 Chrome 和 Chromium 各注册一份逻辑见 浏览器探测配置。✅ 一分钟验证确认扩展和主机已连通3 步确认扩展连接本地服务真的通了。看清单文件。用户级清单在这几个目录Linux~/.config/google-chrome/NativeMessagingHosts/com.chromemcp.nativehost.jsonmacOS~/Library/Application Support/Google/Chrome/NativeMessagingHosts/Windows%APPDATA%\Google\Chrome\NativeMessagingHosts\打开它确认 4 个字段齐全name 是com.chromemcp.nativehosttype 是stdiopath 指向 run_host 脚本allowed_origins 里只有扩展 IDhbdgbgagpkpjffpklnamcljpakneikee。看扩展权限。在 chrome://extensions 确认扩展已启用权限列表里包含nativeMessaging——没有这个权限chrome.runtime.connectNative会直接报权限错误后面的流程根本走不到。点 Connect。扩展发起 connectNative 调用Chrome 按清单拉起 run_host 脚本本机服务随后监听 127.0.0.1:12306。连接成功安装即完成。 看到报错怎么办按错误信息对号入座先别慌chrome native messaging host 安装出的故障基本都能对号入座报错现象处理动作Permission denied或Native host has exitedmacOS/Linux启动脚本丢了执行位pnpm 全局安装尤其常见。跑mcp-chrome-bridge fix-permissions给 3 个关键文件补 755 权限或直接mcp-chrome-bridge doctor --fix自动修Windows 报Access denied注册表 NativeMessagingHosts 读写失败系统策略限制了注册表访问。以管理员身份重开终端再执行 register也可用reg query HKCU\Software\Google\Chrome\NativeMessagingHosts\com.chromemcp.nativehost /ve回读当前值确认指向doctor 报 Node 版本 ERROR主版本 20换 Node 20 后重跑mcp-chrome-bridge register它会把新 Node 路径写进 node_path.txt主机下次启动就换上新版本连接无反应、扩展日志一片空白去看包装脚本日志见文末速查表Chrome 每次拉起主机都会生成一份拿不准就mcp-chrome-bridge report导出脱敏报告再排查native host 权限修复的完整手动步骤见 安装手册各命令参数的定义见 CLI 源码。幕后机制Chrome 如何找到并拉起你的主机把 manifest.json 理解成主机的门牌。Chrome 不会满硬盘找你它只按固定目录翻门牌门牌上写清三件事name门牌号com.chromemcp.nativehostChrome 靠它在 NativeMessagingHosts 目录里定位清单path门铃的位置指向 run_host.shWindows 是 run_host.bat而不是 index.js 本体allowed_origins门禁白名单只有hbdgbgagpkpjffpklnamcljpakneikee这一个扩展 ID 能按门铃其他扩展一律被拒之门外为什么 path 要指向包装脚本因为 Chrome 拉起进程时的 PATH 环境很不可靠run_host 包装脚本 内置了一套按优先级找 Node 的算法先看 CHROME_MCP_NODE_PATH 环境变量再读注册时写下的 node_path.txt然后依次试 Volta、asdf、fnm、nvm、常见安装目录最后才退回 PATH。找到后 exec 真正的 index.js并把整个选型过程记进包装日志。doctor 命令用的是同一套查找顺序所以mcp-chrome-bridge doctor的输出就是 Chrome 实际行为的预演——这正是它能提前揪出注册成功但 Chrome 拉不起来这类隐蔽问题的原因实现见 诊断脚本。进阶选项系统级注册与多浏览器用户级注册只对当前系统用户生效。想让整机所有账户都能用加--system走系统级macOS/Linux 前缀 sudoWindows 直接以管理员身份打开终端再敲命令CLI 会自动检测提权已提权时不带参数也会走系统级分支。系统级清单落在 /Library/Google/Chrome/NativeMessagingHosts/、/etc/opt/chrome/native-messaging-hosts/ 或 Program Files 下的对应目录Windows 还会写 HKLM 注册表。sudo mcp-chrome-bridge register --system多浏览器场景不用重装register -b chromium只注册 Chromium-b all两个都注册--detect只注册探测到的浏览器doctor 和 report 同样支持-b指定目标。速查表常用命令与日志位置命令用途mcp-chrome-bridge register用户级注册自动探测已装浏览器mcp-chrome-bridge register --system系统级注册需管理员/sudomcp-chrome-bridge register -b chrome|chromium|all指定目标浏览器mcp-chrome-bridge doctor诊断清单、权限、Node、端口加--fix自动修复mcp-chrome-bridge fix-permissions修复 3 个关键文件的执行权限mcp-chrome-bridge update-port port修改本地服务端口默认 12306mcp-chrome-bridge report导出脱敏诊断报告--include-logs tail附带日志平台包装脚本日志目录macOS~/Library/Logs/mcp-chrome-bridge/Linux${XDG_STATE_HOME:-~/.local/state}/mcp-chrome-bridge/logs/Windows%LOCALAPPDATA%\mcp-chrome-bridge\logs\日志文件名带时间戳如native_host_wrapper_unix_20261103_140000.log脚本内置轮转每类最多保留 5 份。排查时优先看最新的 stderr 日志Node 崩溃的堆栈都在里面。【免费下载链接】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），仅供参考
