解决AgentDeskAI浏览器工具MCP服务在Cursor中的配置问题

背景介绍

AgentDeskAI的browser-tools-mcp项目是一个浏览器工具集，主要用于在Cursor IDE中实现浏览器与开发环境的深度集成。该项目包含MCP(Message Control Protocol)服务、浏览器连接器和Chrome扩展三个核心组件，能够实现浏览器与开发环境之间的双向通信。

常见问题分析

许多开发者在Windows 10环境下配置该工具时，会遇到"Client closed error"错误。这通常是由于服务配置不当或组件间通信不畅导致的。错误表现为虽然服务地址能够访问，但客户端连接异常中断。

完整解决方案

1. MCP服务配置

首先需要正确设置MCP服务：

1. 克隆项目仓库到本地
2. 进入browser-tools-mcp目录
3. 执行npm或pnpm install安装依赖
4. 运行构建命令npm/pnpm build
5. 在Cursor的MCP设置中添加新服务器
6. 服务器类型选择"command"
7. 命令填写为node <构建路径>/mcp-server.js

2. 浏览器连接器服务配置

浏览器连接器是另一个关键组件，配置步骤如下：

1. 进入browser-tools-server目录
2. 安装依赖(npm/pnpm install)
3. 执行构建命令
4. 在终端运行node <构建路径>/browser-connecter.js
5. 确认终端显示"Aggregator listening on http://127.0.0.1:3025"

3. Chrome扩展安装

1. 在Chrome浏览器中打开扩展程序页面
2. 启用开发者模式
3. 选择"加载已解压的扩展程序"
4. 定位到项目中的chrome-extension目录并加载

使用验证

配置完成后，可以通过以下步骤验证功能是否正常：

1. 打开任意网页或应用
2. 打开开发者工具
3. 确认显示"BrowseTools MCP started debugging on this browser"
4. 在Cursor中使用agent模式
5. 尝试发送指令如"显示浏览器中的所有控制台日志"

注意事项

1. 每个VS Code项目都需要单独运行浏览器连接器服务
2. MCP服务默认会自动运行(会弹出Node窗口)
3. 扩展安装后会自动运行
4. 遇到问题时，首先检查浏览器连接器终端的日志输出
5. 也可以直接使用命令cmd /c npx -y @agentdeskai/browser-tools-mcp@1.1.0快速启动

技术原理

这套工具的核心是基于MCP协议实现的浏览器与开发环境间的通信机制。MCP服务作为消息中转站，浏览器连接器负责与浏览器扩展通信，而Chrome扩展则注入到浏览器中捕获和转发各种事件和数据。三者协同工作，实现了开发环境对浏览器运行时的监控和控制能力。

通过正确配置这三个组件，开发者可以在Cursor IDE中直接获取浏览器运行时的各种信息，显著提升了开发调试的效率。