Files
n8n-mcp/package.runtime.json
czlonkowski 247b4abebb fix: Initialize MCP server for restored sessions (v2.19.4)
Completes session restoration feature by properly initializing MCP server
instances during session restoration, enabling tool calls to work after
server restart.

## Problem

Session restoration successfully restored InstanceContext (v2.19.0) and
transport layer (v2.19.3), but failed to initialize the MCP Server instance,
causing all tool calls on restored sessions to fail with "Server not
initialized" error.

The MCP protocol requires an initialize handshake before accepting tool calls.
When restoring a session, we create a NEW MCP Server instance (uninitialized),
but the client thinks it already initialized (with the old instance before
restart). When the client sends a tool call, the new server rejects it.

## Solution

Created `initializeMCPServerForSession()` method that:
- Sends synthetic initialize request to new MCP server instance
- Brings server into initialized state without requiring client to re-initialize
- Includes 5-second timeout and comprehensive error handling
- Called after `server.connect(transport)` during session restoration flow

## The Three Layers of Session State (Now Complete)

1. Data Layer (InstanceContext): Session configuration  v2.19.0
2. Transport Layer (HTTP Connection): Request/response binding  v2.19.3
3. Protocol Layer (MCP Server Instance): Initialize handshake  v2.19.4

## Changes

- Added `initializeMCPServerForSession()` in src/http-server-single-session.ts:521-605
- Applied initialization in session restoration flow at line 1327
- Added InitializeRequestSchema import from MCP SDK
- Updated versions to 2.19.4 in package.json, package.runtime.json, mcp-engine.ts
- Comprehensive CHANGELOG.md entry with technical details

## Testing

- Build:  Successful compilation with no TypeScript errors
- Type Checking:  No type errors (npm run lint passed)
- Integration Tests:  All 13 session persistence tests passed
- MCP Tools Test:  23 tools tested, 100% success rate
- Code Review:  9.5/10 rating, production ready

## Impact

Enables true zero-downtime deployments for HTTP-based n8n-mcp installations.
Users can now:
- Restart containers without disrupting active sessions
- Continue working seamlessly after server restart
- No need to manually reconnect their MCP clients

Fixes #[issue-number]
Depends on: v2.19.3 (PR #317)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-13 14:19:16 +02:00

33 lines
737 B
JSON

{
"name": "n8n-mcp-runtime",
"version": "2.19.4",
"description": "n8n MCP Server Runtime Dependencies Only",
"private": true,
"main": "dist/index.js",
"types": "dist/index.d.ts",
"exports": {
".": {
"types": "./dist/index.d.ts",
"require": "./dist/index.js",
"import": "./dist/index.js"
}
},
"dependencies": {
"@modelcontextprotocol/sdk": "^1.13.2",
"@supabase/supabase-js": "^2.57.4",
"express": "^5.1.0",
"express-rate-limit": "^7.1.5",
"dotenv": "^16.5.0",
"lru-cache": "^11.2.1",
"sql.js": "^1.13.0",
"uuid": "^10.0.0",
"axios": "^1.7.7"
},
"engines": {
"node": ">=16.0.0"
},
"optionalDependencies": {
"better-sqlite3": "^11.10.0"
}
}