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

{
  "type": "connection",
  "message": "SSE connection established",
  "timestamp": "2024-01-01T12:00:00.000Z",
  "server": "MCP Server"
}

Timestamp Event (elke 5 seconden)

{
  "type": "timestamp",
  "timestamp": "2024-01-01T12:00:05.000Z",
  "uptime": 123.456,
  "memory": {
    "rss": 12345678,
    "heapTotal": 8765432,
    "heapUsed": 5432109,
    "external": 987654
  }
}

Keep-alive Ping (elke 30 seconden)

: keep-alive 1704110400000

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:

cors({
  origin: '*',
  methods: ['GET', 'POST', 'OPTIONS'],
  allowedHeaders: ['Content-Type', 'Cache-Control', 'Accept'],
  credentials: false
})

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

curl https://your-app.onrender.com/health

Server Status

curl https://your-app.onrender.com/mcp/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