mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-02-06 05:23:08 +00:00
05424f66af
* feat: Add session persistence API for zero-downtime deployments (v2.24.1) Implements export/restore functionality for MCP sessions to support container restarts without losing user sessions. This enables zero-downtime deployments for multi-tenant platforms and Kubernetes/Docker environments. New Features: - exportSessionState() - Export active sessions to JSON - restoreSessionState() - Restore sessions from exported data - SessionState type - Serializable session structure - Comprehensive test suite (22 tests, 100% passing) Implementation Details: - Only exports sessions with valid n8nApiUrl and n8nApiKey - Automatically filters expired sessions (respects sessionTimeout) - Validates context structure using existing validation - Handles null/invalid sessions gracefully with warnings - Enforces MAX_SESSIONS limit during restore (100 sessions) - Dormant sessions recreate transport/server on first request Files Modified: - src/http-server-single-session.ts: Core export/restore logic - src/mcp-engine.ts: Public API wrapper methods - src/types/session-state.ts: Type definitions - tests/: Comprehensive unit tests Security Note: Session data contains plaintext n8n API keys. Downstream applications MUST encrypt session data before persisting to disk. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en * feat: implement 7 critical session persistence API fixes for production readiness This commit implements all 7 critical fixes identified in the code review to make the session persistence API production-ready for zero-downtime container deployments in multi-tenant environments. Fixes implemented: 1. Made instanceId optional in SessionState interface 2. Removed redundant validation, properly using validateInstanceContext() 3. Fixed race condition in MAX_SESSIONS check using real-time count 4. Added comprehensive security logging with logSecurityEvent() helper 5. Added duplicate session ID detection during export with Set tracking 6. Added date parsing validation with isNaN checks for Invalid Date objects 7. Restructured null checks for proper TypeScript type narrowing Changes: - src/types/session-state.ts: Made instanceId optional - src/http-server-single-session.ts: Implemented all validation and security fixes - tests/unit/http-server/session-persistence.test.ts: Fixed MAX_SESSIONS test All 13 session persistence unit tests passing. All 9 MCP engine session persistence tests passing. Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>
168 lines
7.4 KiB
JSON
168 lines
7.4 KiB
JSON
{
|
|
"name": "n8n-mcp",
|
|
"version": "2.24.1",
|
|
"description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
|
|
"main": "dist/index.js",
|
|
"types": "dist/index.d.ts",
|
|
"exports": {
|
|
".": {
|
|
"types": "./dist/index.d.ts",
|
|
"require": "./dist/index.js",
|
|
"import": "./dist/index.js"
|
|
}
|
|
},
|
|
"bin": {
|
|
"n8n-mcp": "./dist/mcp/index.js"
|
|
},
|
|
"scripts": {
|
|
"build": "tsc -p tsconfig.build.json",
|
|
"rebuild": "node dist/scripts/rebuild.js",
|
|
"rebuild:optimized": "node dist/scripts/rebuild-optimized.js",
|
|
"validate": "node dist/scripts/validate.js",
|
|
"test-nodes": "node dist/scripts/test-nodes.js",
|
|
"start": "node dist/mcp/index.js",
|
|
"start:http": "MCP_MODE=http node dist/mcp/index.js",
|
|
"start:http:fixed": "MCP_MODE=http USE_FIXED_HTTP=true node dist/mcp/index.js",
|
|
"start:n8n": "N8N_MODE=true MCP_MODE=http node dist/mcp/index.js",
|
|
"http": "npm run build && npm run start:http:fixed",
|
|
"dev": "npm run build && npm run rebuild && npm run validate",
|
|
"dev:http": "MCP_MODE=http nodemon --watch src --ext ts --exec 'npm run build && npm run start:http'",
|
|
"test:single-session": "./scripts/test-single-session.sh",
|
|
"test:mcp-endpoint": "node scripts/test-mcp-endpoint.js",
|
|
"test:mcp-endpoint:curl": "./scripts/test-mcp-endpoint.sh",
|
|
"test:mcp-stdio": "npm run build && node scripts/test-mcp-stdio.js",
|
|
"test": "vitest",
|
|
"test:ui": "vitest --ui",
|
|
"test:run": "vitest run",
|
|
"test:coverage": "vitest run --coverage",
|
|
"test:ci": "vitest run --coverage --coverage.thresholds.lines=0 --coverage.thresholds.functions=0 --coverage.thresholds.branches=0 --coverage.thresholds.statements=0 --reporter=default --reporter=junit",
|
|
"test:watch": "vitest watch",
|
|
"test:unit": "vitest run tests/unit",
|
|
"test:integration": "vitest run --config vitest.config.integration.ts",
|
|
"test:integration:n8n": "vitest run tests/integration/n8n-api",
|
|
"test:cleanup:orphans": "tsx tests/integration/n8n-api/scripts/cleanup-orphans.ts",
|
|
"test:e2e": "vitest run tests/e2e",
|
|
"lint": "tsc --noEmit",
|
|
"typecheck": "tsc --noEmit",
|
|
"update:n8n": "node scripts/update-n8n-deps.js",
|
|
"update:n8n:check": "node scripts/update-n8n-deps.js --dry-run",
|
|
"fetch:templates": "node dist/scripts/fetch-templates.js",
|
|
"fetch:templates:update": "node dist/scripts/fetch-templates.js --update",
|
|
"fetch:templates:extract": "node dist/scripts/fetch-templates.js --extract-only",
|
|
"fetch:templates:robust": "node dist/scripts/fetch-templates-robust.js",
|
|
"prebuild:fts5": "npx tsx scripts/prebuild-fts5.ts",
|
|
"test:templates": "node dist/scripts/test-templates.js",
|
|
"test:protocol-negotiation": "npx tsx src/scripts/test-protocol-negotiation.ts",
|
|
"test:workflow-validation": "node dist/scripts/test-workflow-validation.js",
|
|
"test:template-validation": "node dist/scripts/test-template-validation.js",
|
|
"test:essentials": "node dist/scripts/test-essentials.js",
|
|
"test:enhanced-validation": "node dist/scripts/test-enhanced-validation.js",
|
|
"test:ai-workflow-validation": "node dist/scripts/test-ai-workflow-validation.js",
|
|
"test:mcp-tools": "node dist/scripts/test-mcp-tools.js",
|
|
"test:n8n-manager": "node dist/scripts/test-n8n-manager-integration.js",
|
|
"test:n8n-validate-workflow": "node dist/scripts/test-n8n-validate-workflow.js",
|
|
"test:typeversion-validation": "node dist/scripts/test-typeversion-validation.js",
|
|
"test:error-handling": "node dist/scripts/test-error-handling-validation.js",
|
|
"test:workflow-diff": "node dist/scripts/test-workflow-diff.js",
|
|
"test:transactional-diff": "node dist/scripts/test-transactional-diff.js",
|
|
"test:tools-documentation": "node dist/scripts/test-tools-documentation.js",
|
|
"test:structure-validation": "npx tsx scripts/test-structure-validation.ts",
|
|
"test:url-configuration": "npm run build && ts-node scripts/test-url-configuration.ts",
|
|
"test:search-improvements": "node dist/scripts/test-search-improvements.js",
|
|
"test:fts5-search": "node dist/scripts/test-fts5-search.js",
|
|
"migrate:fts5": "node dist/scripts/migrate-nodes-fts.js",
|
|
"test:mcp:update-partial": "node dist/scripts/test-mcp-n8n-update-partial.js",
|
|
"test:update-partial:debug": "node dist/scripts/test-update-partial-debug.js",
|
|
"test:issue-45-fix": "node dist/scripts/test-issue-45-fix.js",
|
|
"test:auth-logging": "tsx scripts/test-auth-logging.ts",
|
|
"test:docker": "./scripts/test-docker-config.sh all",
|
|
"test:docker:unit": "./scripts/test-docker-config.sh unit",
|
|
"test:docker:integration": "./scripts/test-docker-config.sh integration",
|
|
"test:docker:security": "./scripts/test-docker-config.sh security",
|
|
"sanitize:templates": "node dist/scripts/sanitize-templates.js",
|
|
"db:rebuild": "node dist/scripts/rebuild-database.js",
|
|
"benchmark": "vitest bench --config vitest.config.benchmark.ts",
|
|
"benchmark:watch": "vitest bench --watch --config vitest.config.benchmark.ts",
|
|
"benchmark:ui": "vitest bench --ui --config vitest.config.benchmark.ts",
|
|
"benchmark:ci": "CI=true node scripts/run-benchmarks-ci.js",
|
|
"db:init": "node -e \"new (require('./dist/services/sqlite-storage-service').SQLiteStorageService)(); console.log('Database initialized')\"",
|
|
"docs:rebuild": "ts-node src/scripts/rebuild-database.ts",
|
|
"sync:runtime-version": "node scripts/sync-runtime-version.js",
|
|
"update:readme-version": "node scripts/update-readme-version.js",
|
|
"prepare:publish": "./scripts/publish-npm.sh",
|
|
"update:all": "./scripts/update-and-publish-prep.sh",
|
|
"test:release-automation": "node scripts/test-release-automation.js",
|
|
"prepare:release": "node scripts/prepare-release.js"
|
|
},
|
|
"repository": {
|
|
"type": "git",
|
|
"url": "git+https://github.com/czlonkowski/n8n-mcp.git"
|
|
},
|
|
"keywords": [
|
|
"n8n",
|
|
"mcp",
|
|
"model-context-protocol",
|
|
"ai",
|
|
"workflow",
|
|
"automation"
|
|
],
|
|
"author": "Romuald Czlonkowski @ www.aiadvisors.pl/en",
|
|
"license": "MIT",
|
|
"bugs": {
|
|
"url": "https://github.com/czlonkowski/n8n-mcp/issues"
|
|
},
|
|
"homepage": "https://github.com/czlonkowski/n8n-mcp#readme",
|
|
"files": [
|
|
"dist/**/*",
|
|
"data/nodes.db",
|
|
".env.example",
|
|
"README.md",
|
|
"LICENSE",
|
|
"package.runtime.json"
|
|
],
|
|
"devDependencies": {
|
|
"@faker-js/faker": "^9.9.0",
|
|
"@testing-library/jest-dom": "^6.6.4",
|
|
"@types/better-sqlite3": "^7.6.13",
|
|
"@types/express": "^5.0.3",
|
|
"@types/node": "^22.15.30",
|
|
"@types/ws": "^8.18.1",
|
|
"@vitest/coverage-v8": "^3.2.4",
|
|
"@vitest/runner": "^3.2.4",
|
|
"@vitest/ui": "^3.2.4",
|
|
"axios": "^1.11.0",
|
|
"axios-mock-adapter": "^2.1.0",
|
|
"fishery": "^2.3.1",
|
|
"msw": "^2.10.4",
|
|
"nodemon": "^3.1.10",
|
|
"ts-node": "^10.9.2",
|
|
"typescript": "^5.8.3",
|
|
"vitest": "^3.2.4"
|
|
},
|
|
"dependencies": {
|
|
"@modelcontextprotocol/sdk": "^1.20.1",
|
|
"@n8n/n8n-nodes-langchain": "^1.119.1",
|
|
"@supabase/supabase-js": "^2.57.4",
|
|
"dotenv": "^16.5.0",
|
|
"express": "^5.1.0",
|
|
"express-rate-limit": "^7.1.5",
|
|
"lru-cache": "^11.2.1",
|
|
"n8n": "^1.120.3",
|
|
"n8n-core": "^1.119.2",
|
|
"n8n-workflow": "^1.117.0",
|
|
"openai": "^4.77.0",
|
|
"sql.js": "^1.13.0",
|
|
"tslib": "^2.6.2",
|
|
"uuid": "^10.0.0",
|
|
"zod": "^3.24.1"
|
|
},
|
|
"optionalDependencies": {
|
|
"@rollup/rollup-darwin-arm64": "^4.50.0",
|
|
"@rollup/rollup-linux-x64-gnu": "^4.50.0",
|
|
"better-sqlite3": "^11.10.0"
|
|
},
|
|
"overrides": {
|
|
"pyodide": "0.26.4"
|
|
}
|
|
}
|