ConsoleSpy：用于 Cursor 的 MCP 服务器

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

概述

此工具包含：

1. 一个捕获浏览器控制台日志的服务器
2. 一个使这些日志可用于 Cursor 的 MCP 服务器
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"
   

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

./start-servers.sh

配置 Cursor

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

1. 转到 Settings > Features > MCP in Cursor
2. 添加一个新的 MCP 服务器，并设置：
   • Name: ConsoleSpy
   • Type: sse
   • URL: http://localhost:8766/sse

使用扩展

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

自定义

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

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

1. 在 mcp-server.js 中，更改端口变量：

   const port = 3333; // 更改为您想要的端口
   

2. 在 console-spy-mcp.js 中，更新 URL 以匹配您的新端口：

   const CONSOLE_SERVER_URL = 'http://localhost:3333/mcp'; // 将 3333 更改为您的端口
   

3. 在浏览器扩展的 content.js 中，更新服务器 URL：

   const serverUrl = 'http://localhost:3333/console-logs'; // 将 3333 更改为您的端口
   

4. 如果使用 start-servers.sh，也请在那里更新端口引用。

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

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

故障排除

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

许可证

MIT License

<a href="https://glama.ai/mcp/servers/uVY0ERoHE0"> <img width="380" height="200" src="https://glama.ai/mcp/servers/uVY0ERoHE0/badge" /> </a>