MCP Server with SSE

Een eenvoudige MCP (Model Context Protocol) server met Server-Sent Events (SSE) functionaliteit, geoptimaliseerd voor deployment op Render.com.

Features

• 🚀 Express.js server - Lightweight en snel

• 📡 Server-Sent Events (SSE) - Real-time data streaming

• ⏰ Timestamp broadcasting - Elke 5 seconden

• 💓 Keep-alive pings - Elke 30 seconden

• 🌐 CORS enabled - Cross-origin requests toegestaan

• 🏥 Health checks - Voor Render.com monitoring

• 📊 Status endpoints - Server informatie en statistieken

Endpoints

• GET / - Server informatie en beschikbare endpoints

• GET /health - Health check voor monitoring

• GET /sse - Server-Sent Events stream

• GET /mcp/status - Uitgebreide server status

Local Development

1. Installeer dependencies:

   npm install

2. Start de server:

   npm start # of voor development: npm run dev

3. Test SSE verbinding: Open http://localhost:3000/sse in je browser of gebruik curl:

   curl -N http://localhost:3000/sse

Deployment op Render.com

Automatische Deployment

1. Connect GitHub repository in Render dashboard

2. Selecteer deze repository

3. Render detecteert automatisch de render.yaml configuratie

4. Deploy - Render gebruikt automatisch de configuratie

Handmatige Deployment

1. Maak nieuwe Web Service in Render

2. Configuratie:

   • Build Command: npm install

   • Start Command: npm start

   • Health Check Path: /health

   • Environment: Node.js

   • Plan: Free tier

SSE Data Format

De SSE stream stuurt JSON data in het volgende formaat:

Connection Event

Timestamp Event (elke 5 seconden)

Keep-alive Ping (elke 30 seconden)

Environment Variables

• PORT - Server port (default: 3000, Render sets automatically)

• NODE_ENV - Environment (production/development)

CORS Configuration

De server is geconfigureerd om alle origins toe te staan voor maximale compatibiliteit:

Error Handling

• 500 errors - Gelogd en JSON response

• 404 errors - Friendly message met beschikbare endpoints

• SSE disconnects - Automatic cleanup van intervals

• Graceful shutdown - SIGTERM/SIGINT handling

Monitoring

Health Check

Server Status

Dependencies

• express - Web framework

• cors - Cross-origin resource sharing

License

MIT License - Zie LICENSE bestand voor details.

Support

Voor vragen of issues, maak een GitHub issue aan in deze repository: https://github.com/Fuglys/mcp-server