Servidor MCP para cursor

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para la integración de Cursor IDE, que proporciona un panel de control web moderno y herramientas a través de conexiones SSE (eventos enviados por el servidor) y WebSocket.

Características

• Monitoreo de conexión en tiempo real con soporte WebSocket
• Panel de control web moderno para la gestión de servidores
• Comunicación basada en SSE con Cursor IDE
• Herramienta de prueba incorporada para verificar la conectividad
• Integración de Google Drive para la gestión de archivos
• Arquitectura extensible para agregar nuevas herramientas
• Visualización del historial de conexiones
• Interfaz de gestión de clientes
• Interfaz de usuario de configuración del servicio
• Configuraciones de servidor personalizables

Prerrequisitos

• Python 3.8 o superior
• Node.js 18 o superior
• npm (administrador de paquetes Node.js)
• pip (administrador de paquetes de Python)
• IDE de cursor

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

Desarrollo

Iniciar los servidores de desarrollo:

Los servidores comenzarán en:

• Backend: http://localhost:8765
• Frontend: http://localhost:3000 (o 3001 si el puerto 3000 está en uso)

También puedes iniciar los servidores por separado:

Los servidores de desarrollo proporcionan:

• Recarga en caliente para cambios en la interfaz
• Proxy automático de solicitudes API al backend
• Manejo de conexiones WebSocket
• Desarrollo simultáneo de backend y frontend

Si ejecuta otras aplicaciones que usan el puerto 3000, el frontend probará automáticamente el puerto 3001 e incrementará la velocidad hasta encontrar uno disponible. La URL real se mostrará en la terminal al ejecutar npm run dev .

Estructura del proyecto

Puntos finales disponibles

Puntos finales HTTP

• /api/status - Obtener el estado del servidor
• /api/connections/history - Obtener el historial de conexiones
• /api/clients - Obtener clientes activos
• /api/services/{service_id} - Configuración del servicio
• /api/settings - Configuración del servidor

Punto final de WebSocket

• /ws/{client_id} - Actualizaciones en tiempo real y ping/pong

Punto final de SSE

• /sse - Eventos enviados por el servidor para Cursor IDE

Puntos finales de la herramienta

• /invoke/test - Herramienta de prueba
• /invoke/google_drive - Operaciones de Google Drive

Despliegue de producción

Construya e inicie el servidor de producción:

Configuración

Configuración inicial

1. Copiar la configuración de la plantilla:

2. Actualice services_config.json con sus credenciales de servicio:
   • Para Google Drive:
     • Crear un proyecto en Google Cloud Console
     • Habilitar la API de Google Drive
     • Crear credenciales OAuth 2.0
     • Agregue su client_id y client_secret

Configuración del servidor

Configure los ajustes del servidor a través del panel web:

• Modo de depuración
• Configuración de SSL
• Límites de conexión
• Tiempo de espera de ping
• Configuración del protocolo

Pruebas

Pruebe el servidor utilizando el cliente de prueba proporcionado:

El cliente de prueba hará lo siguiente:

• Conectarse a los puntos finales de SSE y WebSocket
• Enviar pings periódicos
• Pruebe las herramientas disponibles
• Supervisar el estado de la conexión

Solución de problemas

1. Problemas de conexión
   • Verifique los registros tanto del backend como del frontend
   • Verificar la conexión WebSocket en DevTools del navegador
   • Asegúrese de que la configuración del proxy en vite.config.ts sea correcta
   • Comprobar si hay conflictos de puertos
2. Problemas de interfaz
   • Borrar la caché del navegador
   • Comprueba si hay errores en la consola del navegador
   • Verificar las versiones de Node.js y npm
   • Comprobar errores de compilación de TypeScript
3. Problemas de backend
   • Compruebe mcp_server.log para ver si hay errores
   • Verificar que las dependencias de Python estén instaladas
   • Consultar disponibilidad del puerto
   • Asegúrese de que las configuraciones del servicio sean válidas

Notas de seguridad

• El servidor acepta todos los orígenes (CORS * ) en desarrollo
• Las conexiones WebSocket utilizan identificadores de cliente para identificación básica
• Las credenciales del servicio se almacenan en services_config.json
• Se deben utilizar variables de entorno para datos confidenciales en producción

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Realiza tus cambios
4. Ejecutar pruebas
5. Enviar una solicitud de extracción

Licencia

[Agregue la información de su licencia aquí]