MCP WebSocket Server

Servidor WebSocket MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que opera sobre WebSocket. Diseñado para operaciones de correo y comunicación.

Características

• 🔌 Conexión WebSocket
• 📧 Recuperación y búsqueda de correos
• 📊 Estadísticas de correo
• 🚀 Puede alojarse en Render.com
• 🏥 Endpoint de verificación de salud

Instalación

npm install
npm run build
npm start

Uso

Configuración de Claude Desktop

Hay dos formas de configurar Claude Desktop para usar este servidor:

Opción 1: Usar el servidor desplegado en Render (Recomendado)

Agrega a tu archivo %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "mail-mcp-server": {
      "command": "node",
      "args": [
        "C:\\Users\\Thinkpad\\Desktop\\mcp-websocket-server\\stdio-bridge.js",
        "wss://mcp-websocket-server.onrender.com/mcp"
      ]
    }
  }
}

Opción 2: Usar un servidor local

Primero inicia tu servidor local:

npm start

Luego configura Claude Desktop:

{
  "mcpServers": {
    "mail-mcp-server": {
      "command": "node",
      "args": [
        "C:\\Users\\Thinkpad\\Desktop\\mcp-websocket-server\\stdio-bridge.js",
        "ws://localhost:3000/mcp"
      ]
    }
  }
}

Endpoints de API

• / - Interfaz web
• /health - Endpoint de verificación de salud
• /mcp - Endpoint WebSocket para MCP

Herramientas disponibles

• test_baglanti - Prueba la conexión
• mail_getir - Obtén el correo más reciente para una dirección de correo especificada
• mail_ara - Busca dentro del contenido del correo
• mail_istatistik - Muestra estadísticas de correo

Despliegue

Desplegar en Render.com:

1. Haz push a GitHub
2. Crea un nuevo Servicio Web en Render.com
3. Conecta tu repositorio de GitHub
4. Configura los ajustes de compilación:
   • Comando de compilación: npm install && npm run build
   • Comando de inicio: npm start
   • Ruta de verificación de salud: /health

Entorno

• Se requiere Node.js 16.0.0 o superior
• Usa automáticamente la variable de entorno PORT

Pruebas

Prueba tu despliegue:

• Página principal: https://mcp-websocket-server.onrender.com/
• Verificación de salud: https://mcp-websocket-server.onrender.com/health
• WebSocket: wss://mcp-websocket-server.onrender.com/mcp

Prueba la conexión WebSocket directamente:

npm install -g wscat
wscat -c wss://mcp-websocket-server.onrender.com/mcp

Solución de problemas

Si ves errores como "Unexpected token" en los registros de Claude Desktop:

1. Asegúrate de usar el archivo stdio-bridge.js
2. Verifica que la URL de WebSocket sea correcta
3. Comprueba que el servidor esté en ejecución y sea accesible

Licencia

MIT