一、安装前准备

1. 系统要求

• Windows 10/11 操作系统

• Node.js 18.19.0 及以上版本

• Google Chrome 浏览器

2. 工具准备

• 已安装 Node.js 和 npm

• 已安装 Google Chrome 浏览器

二、详细安装步骤

步骤 1: 升级 Node.js (如需要)

如果当前 Node.js 版本低于 18.19.0，需要先升级：

1. 访问 Node.js 官方下载页面：Node.js — Download Node.js®

2. 下载并安装最新的 LTS 版本

3. 验证安装：

   node -v  # 应显示 18.19.0 或更高版本
   npm -v

步骤 2: 修复 npm 命令执行权限问题

如果遇到 "无法加载文件......npm.ps1,因为在此系统上禁止运行脚本" 错误：

1. 以管理员身份运行 PowerShell

2. 执行以下命令：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 验证设置：

   Get-ExecutionPolicy -Scope CurrentUser  # 应显示 RemoteSigned

步骤 3: 安装 mcp-chrome-bridge

1. 打开命令提示符或 PowerShell

2. 执行以下命令：

   npm install -g mcp-chrome-bridge

3. 验证安装：

   npm list -g mcp-chrome-bridge  # 应显示已安装的版本

步骤 4: 注册 Native Messaging host

1. 执行以下命令注册：

   mcp-chrome-bridge register

2. 看到 "Successfully registered user-level Native Messaging host!" 表示注册成功

步骤 5: 启动 mcp-chrome-bridge 服务

1. 执行以下命令启动服务：

   node C:\Users\<你的用户名>\AppData\Roaming\npm\node_modules\mcp-chrome-bridge\dist\index.js

   （注意替换 <你的用户名> 为实际用户名）

2. 服务启动后，命令行可能没有详细输出，但可以通过任务管理器确认 node.exe 进程是否运行

步骤 6: 安装 Chrome 扩展

1. 在 Chrome 浏览器中安装 mcp server 扩展

2. 确保扩展已启用

三、常见问题及解决方案

问题 1: npm 安装时出现 "EBUSY: resource busy or locked" 错误

解决方案：

1. 清除 npm 缓存：

   npm cache clean -f

2. 以管理员权限重新安装：

   Start-Process powershell -ArgumentList '-Command npm install -g mcp-chrome-bridge' -Verb RunAs

问题 2: 运行 mcp-chrome-bridge 命令仅显示帮助信息

解决方案：

• 使用 node 命令直接运行主文件，而不是使用 mcp-chrome-bridge 命令：

  node C:\Users\<你的用户名>\AppData\Roaming\npm\node_modules\mcp-chrome-bridge\dist\index.js

问题 3: 服务启动后没有响应

解决方案：

1. 检查 node.exe 进程是否在运行：

   tasklist | findstr node.exe

2. 检查系统端口监听情况：

   netstat -ano | findstr LISTENING

3. 尝试重启服务和 Chrome 浏览器

四、使用方法

1. 确保 mcp-chrome-bridge 服务已启动

2. 打开 Chrome 浏览器

3. 在 Trae AI 中使用与 Chrome 相关的功能

五、故障排除

1. 确保 Node.js 版本符合要求

2. 确保 Native Messaging host 已正确注册

3. 确保 Chrome 扩展已安装并启用

4. 尝试重启服务和浏览器

5. 查看服务日志或访问项目 GitHub 页面获取更多帮助

六、相关资源

• mcp-chrome GitHub 项目：https://github.com/hangwin/mcp-chrome

• Node.js 官方网站：Node.js — Run JavaScript Everywhere

• Google Chrome 官方网站：https://www.google.com/chrome/