Release v2.12.0
Added
- Flexible Instance Configuration: Complete multi-instance support for serving multiple n8n instances dynamically
- New
InstanceContextinterface for runtime configuration without multi-tenancy implications - Dual-mode API client supporting both singleton (env vars) and instance-specific configurations
- LRU cache with SHA-256 hashing for secure client management (100 instances, 30-min TTL)
- Comprehensive input validation preventing injection attacks and invalid configurations
- Session context management in HTTP server for per-session instance configuration
- 100% backward compatibility - existing deployments work unchanged
- Full test coverage with 83 new tests covering security, caching, and validation
- New
Security
- SHA-256 Cache Key Hashing: All instance identifiers are hashed before caching
- Input Validation: Comprehensive validation for URLs, API keys, and numeric parameters
- Secure Logging: Sensitive data never logged, only partial hashes for debugging
- Memory Management: LRU eviction and TTL prevent unbounded growth
- URL Validation: Blocks dangerous protocols (file://, javascript://, etc.)
Performance
- Efficient Caching: LRU cache with automatic cleanup reduces API client creation
- Fast Lookups: SHA-256 hashed keys for O(1) cache access
- Memory Optimized: Maximum 100 concurrent instances with 30-minute TTL
- Token Savings: Reuses existing clients instead of recreating
Documentation
- Added comprehensive Flexible Instance Configuration Guide
- Detailed architecture, usage examples, and security considerations
- Migration guide for existing deployments
- Complete API documentation for InstanceContext
Installation
NPM Package
# Install globally
npm install -g n8n-mcp
# Or run directly
npx n8n-mcpDocker
# Standard image
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp:v2.12.0
# Railway optimized
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp-railway:v2.12.0Documentation
🤖 Generated with Claude Code