Release v2.13.2

Added

• Operation and Resource Validation with Intelligent Suggestions: New similarity services for n8n node configuration validation

  • OperationSimilarityService: Validates operations and suggests similar alternatives using Levenshtein distance and pattern matching
  • ResourceSimilarityService: Validates resources with automatic plural/singular conversion and typo detection
  • Provides "Did you mean...?" suggestions when invalid operations or resources are used
  • Example: operation: "listFiles" suggests "search" for Google Drive nodes
  • Example: resource: "files" suggests singular "file" with 95% confidence
  • Confidence-based suggestions (minimum 30% threshold) with contextual fix messages
  • Resource-aware operation filtering ensures suggestions are contextually appropriate
  • 5-minute cache duration for performance optimization
  • Integrated into EnhancedConfigValidator for seamless validation flow

• Custom Error Handling: New ValidationServiceError class for better error management

  • Proper error chaining with cause tracking
  • Specialized factory methods for common error scenarios
  • Type-safe error propagation throughout the validation pipeline

Enhanced

• Code Quality and Security Improvements (based on code review feedback):
  • Safe JSON parsing with try-catch error boundaries
  • Type guards for safe property access (getOperationValue, getResourceValue)
  • Memory leak prevention with periodic cache cleanup
  • Performance optimization with early termination for exact matches
  • Replaced magic numbers with named constants for better maintainability
  • Comprehensive JSDoc documentation for all public methods
  • Improved confidence calculation for typos and transpositions

Fixed

• Test Compatibility: Updated test expectations to correctly handle exact match scenarios
• Cache Management: Fixed cache cleanup to prevent unbounded memory growth
• Validation Deduplication: Enhanced config validator now properly replaces base validator errors with detailed suggestions

Testing

• Added comprehensive test coverage for similarity services (37 new tests)
• All unit tests passing with proper edge case handling
• Integration confirmed via n8n-mcp-tester agent validation

Installation

NPM Package

# Install globally
npm install -g n8n-mcp

# Or run directly
npx n8n-mcp

Docker

# Standard image
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp:v2.13.2

# Railway optimized
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp-railway:v2.13.2

Documentation

• Installation Guide
• Docker Deployment
• n8n Integration
• Complete Changelog

🤖 Generated with Claude Code