ConsoleSpy：用于 Cursor 的 MCP 服务器

一种捕获浏览器控制台日志并通过模型上下文协议 (MCP) 使其在 Cursor IDE 中可用的工具。

概述

该工具包括：

1. 从浏览器捕获控制台日志的服务器
2. 一个 MCP 服务器，使这些日志可供 Cursor 使用
3. 将控制台日志发送到服务器的浏览器扩展

安装

服务器设置

1. 克隆此存储库：
   git clone https://github.com/mgsrevolver/consolespy.git cd consolespy
2. 安装依赖项：
   npm install
3. 运行安装脚本来配置 Cursor 的 MCP 连接：
   ./setup.sh

浏览器扩展安装

1. 从Chrome 网上应用店安装扩展程序或者在开发者模式下加载扩展：
   • 打开 Chrome 并转到chrome://extensions/
   • 启用“开发者模式”（在右上角切换）
   • 单击“加载解压的”并从此存储库中选择extension文件夹

用法

启动服务器

1. 启动控制台日志服务器：
   node mcp-server.js
2. 在单独的终端中，启动 MCP 服务器：
   npx supergateway --port 8766 --stdio "node console-spy-mcp.js"

或者，您可以使用启动脚本同时启动两个服务器：

配置光标

运行安装脚本后，您仍然需要在 Cursor 中手动添加 MCP 服务器：

1. 前往“设置”>“功能”>“光标中的 MCP”
2. 添加新的 MCP 服务器：
   • 名称：ConsoleSpy
   • 类型：sse
   • 网址： http://localhost:8766/sse

使用扩展

1. 单击浏览器中的扩展程序图标即可打开/关闭它
2. 启用后，当前选项卡的所有控制台日志都将发送到服务器
3. 在 Cursor 中，您现在可以通过 MCP 界面访问这些日志

定制

更改控制台日志服务器端口

如果您需要为控制台日志服务器使用不同的端口（默认为 3333），则需要在多个地方更新端口：

1. 在mcp-server.js中，更改端口变量：
   const port = 3333; // Change to your desired port
2. 在console-spy-mcp.js中，更新 URL 以匹配你的新端口：
   const CONSOLE_SERVER_URL = 'http://localhost:3333/mcp'; // Change 3333 to your port
3. 在浏览器扩展的content.js中，更新服务器 URL：
   const serverUrl = 'http://localhost:3333/console-logs'; // Change 3333 to your port
4. 如果使用start-servers.sh ，也请在那里更新端口引用。

**重要提示：**您必须在所有位置使用相同的端口号。我们建议您在项目文件中全局搜索“3333”，并将所有实例替换为所需的端口号，以确保一致性。

如果您正在本地测试另一个已使用端口 3333 的应用程序，则更改此端口对于该工具正常工作至关重要。

故障排除

• 确保两台服务器都在运行
• 验证您正在调试的选项卡是否已启用浏览器扩展
• 检查您是否已在 Cursor 的设置中添加了 MCP 服务器
• 如果日志未显示，请尝试刷新页面或重新启动服务器

执照

MIT 许可证