ConsoleSpy: An MCP Server for Cursor

ConsoleSpy: An MCP Server for Cursor

site icon
2025.03.08 7
JavaScript开发辅助工具浏览器调试工具开发效率
ConsoleSpy 是一个基于 Model Context Protocol (MCP) 的工具,用于捕获浏览器控制台日志并将其提供给 Cursor IDE 使用。该工具包含一个服务器、一个 MCP 服务器和一个浏览器扩展,能够实时捕获和传输浏览器控制台日志,方便开发者在 Cursor IDE 中查看和调试。
View on GitHub

Overview

基本能力

产品定位

ConsoleSpy 是一个开发辅助工具,旨在帮助开发者通过 Cursor IDE 实时查看和调试浏览器控制台日志。

核心功能

  1. 捕获浏览器控制台日志:通过浏览器扩展捕获当前标签页的控制台日志。
  2. MCP 服务器:将捕获的日志通过 MCP 协议提供给 Cursor IDE。
  3. 实时传输:日志实时传输到 Cursor IDE,方便开发者调试。

适用场景

  1. 前端开发调试:在开发过程中实时查看浏览器控制台日志。
  2. 远程调试:通过 Cursor IDE 远程调试浏览器中的问题。
  3. 团队协作:共享控制台日志,便于团队协作解决问题。

工具列表

  1. 浏览器扩展:捕获并发送控制台日志到服务器。
  2. MCP 服务器:将日志通过 MCP 协议提供给 Cursor IDE。
  3. 控制台日志服务器:接收并处理浏览器扩展发送的日志。

常见问题解答

  1. 日志未显示:确保服务器和浏览器扩展已启用,且 Cursor IDE 中已正确配置 MCP 服务器。
  2. 端口冲突:如果默认端口 3333 被占用,需修改所有相关文件中的端口号。
  3. 扩展未生效:检查浏览器扩展是否已启用,并刷新页面。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 安装依赖: bash npm install

安装教程

  1. 克隆仓库: bash git clone https://github.com/mgsrevolver/consolespy.git cd consolespy
  2. 安装依赖: bash npm install
  3. 运行安装脚本: bash ./setup.sh
  4. 安装浏览器扩展:
  5. Chrome Web Store 安装。
  6. 或手动加载扩展(开发者模式)。

调试方式

  1. 启动控制台日志服务器: bash node mcp-server.js
  2. 启动 MCP 服务器: bash npx supergateway --port 8766 --stdio "node console-spy-mcp.js"
  3. 在 Cursor IDE 中配置 MCP 服务器:
  4. 名称:ConsoleSpy
  5. 类型:sse
  6. URL:http://localhost:8766/sse
  7. 启用浏览器扩展并刷新页面。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。