一、安装 Chrome 扩展

1. 打开 Chrome 网上应用店，搜索 "Cursor" 或直接访问扩展链接。
2. 点击 "添加至 Chrome"。
3. 在弹出的确认框中点击 "添加扩展程序"。
4. 等待安装完成，您将在 Chrome 工具栏看到 Cursor 图标。

二、配置 Cursor MCP

1. 登录 Cursor

# 在终端中登录 Cursor（如果需要的话）
cursor login

2. 配置 MCP

• 点击 Chrome 工具栏中的 Cursor 图标。
• 进入 设置页面。
• 在 "MCP Configuration" 部分，填入以下信息：MCP Host: localhost MCP Port: 3000

3. 验证 MCP 配置

• 点击 "Test Connection"。
• 如果配置正确，将看到 "Connection Successful" 的提示。

三、安装并配置 BrowserTools 服务

1. 安装必要工具

# 安装 Node.js 和 npm（如果尚未安装）
brew install node

# 安装 PM2 进程管理器
npm install -g pm2

# 安装 browser-tools-server
npm install -g @agentdeskai/browser-tools-server@1.2.0

2. 启动 BrowserTools 服务

# 使用 PM2 启动 BrowserTools 服务
pm2 start "npx @agentdeskai/browser-tools-server@1.2.0" --name "browser-tools"

# 查看服务状态
pm2 status

3. 配置开机自启动

# 生成开机自启动脚本
pm2 startup

# 保存当前进程列表
pm2 save

四、验证安装

1. 检查服务状态

# 检查 BrowserTools 服务状态
pm2 status browser-tools

# 查看服务日志
pm2 logs browser-tools

2. 验证 Chrome 扩展

• 打开 Chrome 开发者工具（F12）。
• 在 Console 面板检查是否有错误信息。
• 确认 Cursor 图标是否正常显示。

3. 测试集成

• 在 Chrome 中打开一个网页。
• 点击 Cursor 图标。
• 尝试使用 MCP 功能。
• 检查是否能正常响应。

五、故障排除

1. BrowserTools 服务问题

# 查看详细日志
pm2 logs browser-tools

# 重启服务
pm2 restart browser-tools

# 检查端口占用（如 3000 端口）
lsof -i :3000
kill -9 <进程ID>

2. Chrome 扩展问题

扩展无法加载

1. 进入 Chrome 扩展管理页面（chrome://extensions/）。
2. 禁用后重新启用 Cursor 扩展。
3. 清除 浏览器缓存。

MCP 连接失败

1. 确认 BrowserTools 服务是否在运行。
2. 验证 MCP 配置是否正确。
3. 检查 防火墙设置是否拦截了请求。

六、最佳实践

1. 定期维护

# 更新服务
npm update -g @agentdeskai/browser-tools-server

# 重启服务
pm2 restart browser-tools

2. 日志管理

# 安装 PM2 日志轮转插件
pm2 install pm2-logrotate

# 查看最近的日志
pm2 logs browser-tools --lines 100

3. 性能监控

# 监控服务状态
pm2 monit

七、环境要求

• Node.js 14+
• Chrome 88+
• macOS 10.15+ / Windows 10+ / Linux
• 稳定的网络连接

八、注意事项

1. 确保系统时间准确。
2. 保持足够的磁盘空间。
3. 定期检查服务状态。
4. 保持 Chrome 浏览器更新。
5. 注意网络防火墙设置。

九、常用命令速查

服务管理

pm2 start browser-tools    # 启动服务
pm2 stop browser-tools     # 停止服务
pm2 restart browser-tools  # 重启服务
pm2 delete browser-tools   # 删除服务

日志查看

pm2 logs browser-tools     # 查看日志
pm2 flush                  # 清空日志

状态监控

pm2 status                 # 查看状态
pm2 monit                  # 监控面板

十、相关资源

• Cursor 官方文档
• PM2 文档
• Chrome 开发者文档
• Node.js 文档

希望这个完整指南能帮助您成功设置和配置 Cursor MCP 与 BrowserTools 服务！ 如果遇到问题，请参考 故障排除 部分或查阅相关文档。