MCP Server with SSE

# Deployment Guide - MCP Server op Render.com ## 🚀 Snelle Deployment ### Stap 1: GitHub Repository ✅ **Repository is klaar:** `https://github.com/Fuglys/mcp-server` ### Stap 2: Render.com Setup 1. **Ga naar** [render.com](https://render.com) 2. **Log in** met je GitHub account 3. **Klik** "New +" → "Web Service" 4. **Connect** deze GitHub repository 5. **Render detecteert automatisch** de configuratie via `render.yaml` ### Stap 3: Automatische Configuratie Render gebruikt automatisch deze instellingen uit `render.yaml`: - **Build Command:** `npm install` - **Start Command:** `npm start` - **Health Check:** `/health` - **Environment:** Node.js - **Plan:** Free tier ### Stap 4: Deploy 1. **Klik** "Create Web Service" 2. **Wacht** op deployment (2-3 minuten) 3. **Test** je SSE endpoint: `https://your-app.onrender.com/sse` ## 📡 Endpoints na Deployment ### Base URL ``` https://your-app-name.onrender.com ``` ### Beschikbare Endpoints - `GET /` - Server informatie - `GET /health` - Health check - `GET /sse` - Server-Sent Events stream - `GET /mcp/status` - Uitgebreide status ## 🧪 Testing na Deployment ### 1. Health Check ```bash curl https://your-app.onrender.com/health ``` ### 2. SSE Stream Test ```bash curl -N https://your-app.onrender.com/sse ``` ### 3. Browser Test Open in browser: `https://your-app.onrender.com/sse` ## 🔧 Troubleshooting ### Common Issues #### 1. Build Fails - **Check** `package.json` dependencies - **Verify** Node.js version compatibility - **Review** build logs in Render dashboard #### 2. Health Check Fails - **Verify** `/health` endpoint responds - **Check** server startup logs - **Ensure** port binding to `0.0.0.0` #### 3. SSE Connection Issues - **Test** CORS headers - **Verify** keep-alive functionality - **Check** browser network tab ### Debug Commands ```bash # Test lokaal npm start curl http://localhost:3000/health # Test SSE lokaal node test-sse.js ``` ## 📊 Monitoring ### Render Dashboard - **Logs** - Real-time server logs - **Metrics** - CPU, Memory, Response times - **Events** - Deployment history ### Custom Monitoring ```bash # Health check monitoring curl -f https://your-app.onrender.com/health || echo "Health check failed" # SSE connection test timeout 10 curl -N https://your-app.onrender.com/sse ``` ## 🔄 Updates ### Automatische Updates - **Push** naar main branch - **Render** detecteert wijzigingen automatisch - **Auto-deploy** binnen 2-3 minuten ### Handmatige Deploy 1. **Ga naar** Render dashboard 2. **Selecteer** je service 3. **Klik** "Manual Deploy" → "Deploy latest commit" ## 💡 Tips ### Performance - **Free tier** heeft cold starts (30 seconden inactivity) - **Keep-alive** pings helpen tegen cold starts - **Upgrade** naar betaald plan voor 24/7 uptime ### Security - **CORS** is open voor alle origins (development friendly) - **Pas aan** voor productie gebruik - **Voeg** rate limiting toe indien nodig ### Scaling - **Free tier:** 1 instance - **Betaalde plannen:** Auto-scaling beschikbaar - **Database:** Voeg PostgreSQL toe via Render ## 🆘 Support ### Render Support - **Documentation:** [render.com/docs](https://render.com/docs) - **Community:** [community.render.com](https://community.render.com) - **Status:** [status.render.com](https://status.render.com) ### Project Support - **GitHub Issues:** [github.com/Fuglys/mcp-server/issues](https://github.com/Fuglys/mcp-server/issues) - **README:** Zie hoofddocumentatie in README.md