servicenow-mcp-server 2.1.5 → 2.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "servicenow-mcp-server",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Multi-instance ServiceNow MCP server with 40+ tools, natural language search, and local script development",
   "main": "src/server.js",
   "type": "module",

package/RESPONSE_DRAFT.md

@@ -1,229 +0,0 @@
-# Response to SSE Connection Issue
-
----
-
-## Your Message:
-
-Hey [Name],
-
-Thanks for reporting this issue! You're absolutely right - the SSE connection was dropping in Docker environments. I've identified and **fixed the root cause** in **v2.1.5** (just published).
-
-### What Was Wrong
-
-The SSE connection had no keepalive mechanism, so:
-- Proxies/load balancers timed out idle connections (typically 60-120 seconds)
-- Docker networking killed idle TCP connections
-- Express default timeouts closed long-running connections
-
-### The Fix ✅
-
-I've implemented an **automatic keepalive heartbeat** that:
-- Sends invisible SSE comments every 15 seconds (configurable)
-- Keeps the connection alive indefinitely
-- Works seamlessly behind nginx, Traefik, HAProxy, etc.
-- Zero configuration required (works out of the box)
-
-### How to Use (Quick Start)
-
-**Pull the latest version:**
-```bash
-docker pull nczitzer/mcp-servicenow-nodejs:latest
-```
-
-**Run it:**
-```bash
-docker run -d \
-  --name servicenow-mcp \
-  -p 3000:3000 \
-  -e SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
-  -e SERVICENOW_USERNAME=admin \
-  -e SERVICENOW_PASSWORD=password \
-  nczitzer/mcp-servicenow-nodejs:latest
-```
-
-**Test the connection (you should see keepalive comments every 15 seconds):**
-```bash
-curl -N http://localhost:3000/mcp
-
-# Expected output:
-event: endpoint
-data: /message
-
-: keepalive
-
-: keepalive
-```
-
-### Configuration (Optional)
-
-If you need to tune the keepalive interval:
-
-```yaml
-# docker-compose.yml
-services:
-  servicenow-mcp-server:
-    image: nczitzer/mcp-servicenow-nodejs:latest
-    environment:
-      - SSE_KEEPALIVE_INTERVAL=15000  # milliseconds (default: 15s)
-```
-
-**Recommended settings:**
-- **Default (15s)** - Works for most environments
-- **Behind aggressive proxies (10s)** - Use `SSE_KEEPALIVE_INTERVAL=10000`
-- **Low-latency networks (30s)** - Use `SSE_KEEPALIVE_INTERVAL=30000`
-
-### If You're Using nginx
-
-Make sure to disable buffering for the SSE endpoint:
-
-```nginx
-location /mcp {
-    proxy_pass http://servicenow-mcp:3000;
-
-    # CRITICAL for SSE
-    proxy_buffering off;
-    proxy_cache off;
-    proxy_read_timeout 86400s;  # 24 hours
-
-    proxy_http_version 1.1;
-    proxy_set_header Connection '';
-    proxy_set_header X-Accel-Buffering 'no';
-}
-```
-
-### Complete Documentation
-
-I've created comprehensive docs for SSE setup:
-- **[SSE Docker Setup Guide](https://github.com/Happy-Technologies-LLC/mcp-servicenow-nodejs/blob/main/docs/SSE_DOCKER_SETUP.md)** - Complete guide with troubleshooting
-- **[Quick Reference](https://github.com/Happy-Technologies-LLC/mcp-servicenow-nodejs/blob/main/docs/SSE_FIX_SUMMARY.md)** - TL;DR version
-
-### Verification
-
-Check that it's working:
-
-```bash
-# 1. Check server logs
-docker logs servicenow-mcp-server
-
-# Look for:
-💓 SSE keepalive interval: 15000ms
-🔗 New session established: <session-id>
-
-# 2. Monitor the connection
-curl -N http://localhost:3000/mcp
-# You should see ": keepalive" comments every 15 seconds
-```
-
-### Summary
-
-- ✅ **v2.1.5 published** to npm and Docker Hub
-- ✅ **Automatic keepalive** prevents connection drops
-- ✅ **Works out of the box** - no configuration needed
-- ✅ **Fully documented** with examples and troubleshooting
-
-The connection should now stay alive indefinitely! Let me know if you run into any issues.
-
-Thanks again for reporting this - it's now fixed for everyone! 🎉
-
-Best,
-[Your Name]
-
----
-
-## Alternative (Shorter Version):
-
-Hey [Name],
-
-Great catch! I've fixed the SSE connection dropping issue in **v2.1.5** (just published).
-
-**What I fixed:**
-- Added automatic keepalive heartbeat (every 15 seconds)
-- Disabled timeouts for SSE endpoint
-- Added proxy-friendly headers
-
-**How to use:**
-```bash
-docker pull nczitzer/mcp-servicenow-nodejs:latest
-docker run -d -p 3000:3000 \
-  -e SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
-  -e SERVICENOW_USERNAME=admin \
-  -e SERVICENOW_PASSWORD=password \
-  nczitzer/mcp-servicenow-nodejs:latest
-```
-
-**Test it:**
-```bash
-curl -N http://localhost:3000/mcp
-# You'll see ": keepalive" comments every 15 seconds
-```
-
-**Full docs:** https://github.com/Happy-Technologies-LLC/mcp-servicenow-nodejs/blob/main/docs/SSE_DOCKER_SETUP.md
-
-The connection should now stay alive indefinitely. Let me know if you have any issues!
-
-Thanks for reporting! 🙏
-
----
-
-## GitHub Issue Template (If responding on GitHub):
-
-## Fixed in v2.1.5 ✅
-
-Thanks for reporting this! The SSE connection dropping issue has been **fixed in v2.1.5**.
-
-### Root Cause
-The server had no keepalive mechanism, causing proxies and Docker networking to timeout idle SSE connections.
-
-### Solution
-Implemented automatic keepalive heartbeat that sends invisible SSE comments every 15 seconds (configurable).
-
-### How to Use
-
-**1. Pull the latest version:**
-```bash
-docker pull nczitzer/mcp-servicenow-nodejs:latest
-```
-
-**2. Run it:**
-```bash
-docker run -d \
-  --name servicenow-mcp \
-  -p 3000:3000 \
-  -e SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
-  -e SERVICENOW_USERNAME=admin \
-  -e SERVICENOW_PASSWORD=password \
-  nczitzer/mcp-servicenow-nodejs:latest
-```
-
-**3. Test the connection:**
-```bash
-curl -N http://localhost:3000/mcp
-# You should see ": keepalive" comments every 15 seconds
-```
-
-### Configuration
-
-Optional tuning via environment variable:
-```yaml
-environment:
-  - SSE_KEEPALIVE_INTERVAL=15000  # milliseconds (default: 15s)
-```
-
-### Documentation
-
-- [Complete SSE Setup Guide](docs/SSE_DOCKER_SETUP.md)
-- [Quick Reference](docs/SSE_FIX_SUMMARY.md)
-
-### Changes
-- ✅ Automatic keepalive heartbeat (configurable)
-- ✅ Disabled timeouts for SSE endpoint
-- ✅ Proxy-friendly headers (`X-Accel-Buffering: no`)
-- ✅ Connection monitoring with automatic cleanup
-
-The connection should now stay alive indefinitely! Let me know if you encounter any issues.
-
-Closing this as **resolved** in v2.1.5. Feel free to reopen if needed.
-
----
-
-**Choose the version that fits your communication style!**