基本能力
产品定位
ConsoleSpy 是一个开发辅助工具,旨在帮助开发者通过 Cursor IDE 实时查看和调试浏览器控制台日志。
核心功能
- 捕获浏览器控制台日志:通过浏览器扩展捕获当前标签页的控制台日志。
- MCP 服务器:将捕获的日志通过 MCP 协议提供给 Cursor IDE。
- 实时传输:日志实时传输到 Cursor IDE,方便开发者调试。
适用场景
- 前端开发调试:在开发过程中实时查看浏览器控制台日志。
- 远程调试:通过 Cursor IDE 远程调试浏览器中的问题。
- 团队协作:共享控制台日志,便于团队协作解决问题。
工具列表
- 浏览器扩展:捕获并发送控制台日志到服务器。
- MCP 服务器:将日志通过 MCP 协议提供给 Cursor IDE。
- 控制台日志服务器:接收并处理浏览器扩展发送的日志。
常见问题解答
- 日志未显示:确保服务器和浏览器扩展已启用,且 Cursor IDE 中已正确配置 MCP 服务器。
- 端口冲突:如果默认端口 3333 被占用,需修改所有相关文件中的端口号。
- 扩展未生效:检查浏览器扩展是否已启用,并刷新页面。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 安装依赖:
bash
npm install
安装教程
- 克隆仓库:
bash
git clone https://github.com/mgsrevolver/consolespy.git
cd consolespy - 安装依赖:
bash
npm install - 运行安装脚本:
bash
./setup.sh - 安装浏览器扩展:
- 从 Chrome Web Store 安装。
- 或手动加载扩展(开发者模式)。
调试方式
- 启动控制台日志服务器:
bash
node mcp-server.js - 启动 MCP 服务器:
bash
npx supergateway --port 8766 --stdio "node console-spy-mcp.js" - 在 Cursor IDE 中配置 MCP 服务器:
- 名称:ConsoleSpy
- 类型:sse
- URL:http://localhost:8766/sse
- 启用浏览器扩展并刷新页面。