ConsoleSpy: Un servidor MCP para cursor

Una herramienta que captura los registros de la consola del navegador y los pone a disposición en Cursor IDE a través del Protocolo de contexto de modelo (MCP).

Descripción general

Esta herramienta consta de:

1. Un servidor que captura los registros de la consola de su navegador

2. Un servidor MCP que pone estos registros a disposición de Cursor

3. Una extensión del navegador que envía registros de la consola al servidor

Instalación

Configuración del servidor

1. Clonar este repositorio:

   git clone https://github.com/mgsrevolver/consolespy.git cd consolespy

2. Instalar dependencias:

   npm install

3. Ejecute el script de configuración para configurar la conexión MCP para Cursor:

   ./setup.sh

Instalación de extensiones del navegador

1. Instalar la extensión desde Chrome Web Store

   O

   Cargar la extensión en modo desarrollador:

   • Abra Chrome y vaya a chrome://extensions/

   • Habilitar el "Modo de desarrollador" (cambio en la esquina superior derecha)

   • Haga clic en "Cargar descomprimido" y seleccione la carpeta extension de este repositorio

Uso

Iniciando los servidores

1. Inicie el servidor de registro de la consola:

   node mcp-server.js

2. En una terminal separada, inicie el servidor MCP:

   npx supergateway --port 8766 --stdio "node console-spy-mcp.js"

Alternativamente, puede utilizar el script de inicio para iniciar ambos servidores a la vez:

Configuración del cursor

Después de ejecutar el script de configuración, aún deberá agregar manualmente el servidor MCP en Cursor:

1. Vaya a Configuración > Funciones > MCP en Cursor

2. Agregue un nuevo servidor MCP con:

   • Nombre: ConsoleSpy

   • Tipo: sse

   • URL: http://localhost:8766/sse

Usando la extensión

1. Haga clic en el icono de la extensión en su navegador para activarla o desactivarla.

2. Cuando está habilitado, todos los registros de la consola de la pestaña actual se enviarán al servidor

3. En Cursor, ahora puede acceder a estos registros a través de la interfaz MCP

Personalización

Cambiar el puerto del servidor de registro de la consola

Si necesita utilizar un puerto diferente para el servidor de registro de la consola (el predeterminado es 3333), deberá actualizar el puerto en varios lugares:

1. En mcp-server.js , cambie la variable del puerto:

   const port = 3333; // Change to your desired port

2. En console-spy-mcp.js , actualice la URL para que coincida con su nuevo puerto:

   const CONSOLE_SERVER_URL = 'http://localhost:3333/mcp'; // Change 3333 to your port

3. En el content.js de la extensión del navegador, actualice la URL del servidor:

   const serverUrl = 'http://localhost:3333/console-logs'; // Change 3333 to your port

4. Si usa start-servers.sh , actualice la referencia del puerto allí también.

Importante: Debe usar el mismo número de puerto en todas las ubicaciones. Recomendamos realizar una búsqueda global de "3333" en los archivos del proyecto y reemplazar todas las instancias con el número de puerto deseado para garantizar la coherencia.

Si está realizando pruebas localmente con otra aplicación que ya usa el puerto 3333, cambiar este puerto es esencial para que la herramienta funcione correctamente.

Solución de problemas

• Asegúrese de que ambos servidores estén en ejecución

• Verifique que la extensión del navegador esté habilitada para la pestaña que está depurando

• Comprueba que has agregado el servidor MCP en la configuración de Cursor

• Si no aparecen los registros, intente actualizar la página o reiniciar los servidores.

Licencia

Licencia MIT