fix: deprecate USE_FIXED_HTTP for SSE streaming support (Issue #524) (#525)

* fix: deprecate USE_FIXED_HTTP for SSE streaming support (Issue #524)

The fixed HTTP implementation does not support SSE streaming required
by clients like OpenAI Codex. This commit deprecates USE_FIXED_HTTP
and makes SingleSessionHTTPServer the default.

Changes:
- Add deprecation warnings in src/mcp/index.ts and src/http-server.ts
- Remove USE_FIXED_HTTP from docker-compose.yml and Dockerfile.railway
- Update .env.example with deprecation notice
- Rename npm script to start:http:fixed:deprecated
- Update all documentation to remove USE_FIXED_HTTP references
- Mark test case as deprecated

Users should unset USE_FIXED_HTTP to use the modern SingleSessionHTTPServer
which supports both JSON-RPC and SSE streaming.

Closes #524

Concieved by Romuald Członkowski - www.aiadvisors.pl/en

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: bump version to 2.31.8 and add CHANGELOG entry

- Fix comment inaccuracy: "deprecated" not "deprecated and removed"
- Bump version from 2.31.7 to 2.31.8
- Add CHANGELOG entry documenting USE_FIXED_HTTP deprecation
- Update all deprecation messages to reference v2.31.8

Concieved by Romuald Członkowski - www.aiadvisors.pl/en

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

docs/DOCKER_README.md

@@ -21,7 +21,6 @@ cd n8n-mcp
 # Create .env file with auth token
 cat > .env << EOF
 AUTH_TOKEN=$(openssl rand -base64 32)
-USE_FIXED_HTTP=true
 EOF
 
 # Start the server
@@ -46,7 +45,6 @@ docker pull ghcr.io/czlonkowski/n8n-mcp:latest
 docker run -d \
   --name n8n-mcp \
   -e MCP_MODE=http \
-  -e USE_FIXED_HTTP=true \
   -e AUTH_TOKEN=your-secure-token \
   -p 3000:3000 \
   ghcr.io/czlonkowski/n8n-mcp:latest

docs/HTTP_DEPLOYMENT.md

@@ -67,7 +67,6 @@ Claude Desktop → mcp-remote → https://your-server.com
 # 1. Create environment file
 cat > .env << EOF
 AUTH_TOKEN=$(openssl rand -base64 32)
-USE_FIXED_HTTP=true
 MCP_MODE=http
 PORT=3000
 # Optional: Enable n8n management tools
@@ -106,7 +105,6 @@ npm run rebuild
 
 # 2. Configure environment
 export MCP_MODE=http
-export USE_FIXED_HTTP=true  # Important: Use fixed implementation
 export AUTH_TOKEN=$(openssl rand -base64 32)
 export PORT=3000
 
@@ -144,7 +142,6 @@ Skip HTTP entirely and use stdio mode directly:
 | Variable | Description | Example |
 |----------|-------------|------|
 | `MCP_MODE` | Must be set to `http` | `http` |
-| `USE_FIXED_HTTP` | **Important**: Set to `true` for stable implementation | `true` |
 | `AUTH_TOKEN` or `AUTH_TOKEN_FILE` | Authentication method | See security section |
 
 ### Optional Settings
@@ -417,7 +414,6 @@ services:
     environment:
       # Core configuration
       MCP_MODE: http
-      USE_FIXED_HTTP: true
       NODE_ENV: production
       
       # Security - Using file-based secret
@@ -500,7 +496,6 @@ WorkingDirectory=/opt/n8n-mcp
 # Use file-based secret
 Environment="AUTH_TOKEN_FILE=/etc/n8n-mcp/auth_token"
 Environment="MCP_MODE=http"
-Environment="USE_FIXED_HTTP=true"
 Environment="NODE_ENV=production"
 Environment="TRUST_PROXY=1"
 Environment="BASE_URL=https://n8n-mcp.example.com"
@@ -772,8 +767,8 @@ sudo ufw status  # Linux
 ```
 
 **"Stream is not readable":**
-- Ensure `USE_FIXED_HTTP=true` is set
-- Fixed in v2.3.2+
+- This issue was fixed in v2.3.2+ with the SingleSessionHTTPServer
+- No additional configuration needed
 
 **Bridge script not working:**
 ```bash

docs/INSTALLATION.md

@@ -18,7 +18,6 @@ The fastest way to get n8n-MCP running:
 # Using Docker (recommended)
 cat > .env << EOF
 AUTH_TOKEN=$(openssl rand -base64 32)
-USE_FIXED_HTTP=true
 EOF
 docker compose up -d
 ```
@@ -49,7 +48,6 @@ docker compose up -d
        
        environment:
          MCP_MODE: ${MCP_MODE:-http}
-         USE_FIXED_HTTP: ${USE_FIXED_HTTP:-true}
          AUTH_TOKEN: ${AUTH_TOKEN:?AUTH_TOKEN is required}
          NODE_ENV: ${NODE_ENV:-production}
          LOG_LEVEL: ${LOG_LEVEL:-info}

docs/RAILWAY_DEPLOYMENT.md

@@ -98,7 +98,6 @@ These are automatically set by the Railway template:
 |----------|--------------|-------------|
 | `AUTH_TOKEN` | `REPLACE_THIS...` | **⚠️ CHANGE IMMEDIATELY** |
 | `MCP_MODE` | `http` | Required for cloud deployment |
-| `USE_FIXED_HTTP` | `true` | Stable HTTP implementation |
 | `NODE_ENV` | `production` | Production optimizations |
 | `LOG_LEVEL` | `info` | Balanced logging |
 | `TRUST_PROXY` | `1` | Railway runs behind proxy |

docs/README.md

@@ -40,7 +40,6 @@ Key configuration options:
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `MCP_MODE` | Server mode: `stdio` or `http` | `stdio` |
-| `USE_FIXED_HTTP` | Use fixed HTTP implementation (v2.3.2+) | `true` |
 | `AUTH_TOKEN` | Authentication token for HTTP mode | Required |
 | `PORT` | HTTP server port | `3000` |
 | `LOG_LEVEL` | Logging verbosity | `info` |