Release v2.10.5

Updated

• n8n Dependencies: Updated to latest versions for compatibility and new features
  • n8n: 1.106.3 → 1.107.4
  • n8n-core: 1.105.3 → 1.106.2
  • n8n-workflow: 1.103.3 → 1.104.1
  • @n8n/n8n-nodes-langchain: 1.105.3 → 1.106.2
• Node Database: Rebuilt with 535 nodes from updated n8n packages
• All tests passing with updated dependencies

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.10.5

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

Documentation

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

🤖 Generated with Claude Code

Release v2.10.3

Fixed

• Validation System Robustness: Fixed multiple critical validation issues affecting AI agents and workflow validation (fixes czlonkowski#58, czlonkowski#68, czlonkowski#70, czlonkowski#73)
  • Issue czlonkowski#73: Fixed validate_node_minimal crash when config is undefined
    • Added safe property access with optional chaining (config?.resource)
    • Tool now handles undefined, null, and malformed configs gracefully
  • Issue czlonkowski#58: Fixed validate_node_operation crash on invalid nodeType
    • Added type checking before calling string methods
    • Prevents "Cannot read properties of undefined (reading 'replace')" error
  • Issue czlonkowski#70: Fixed validation profile settings being ignored
    • Extended profile parameter to all validation phases (nodes, connections, expressions)
    • Added Sticky Notes filtering to reduce false positives
    • Enhanced cycle detection to allow legitimate loops (SplitInBatches)
  • Issue czlonkowski#68: Added error recovery suggestions for AI agents
    • New addErrorRecoverySuggestions() method provides actionable recovery steps
    • Categorizes errors and suggests specific fixes for each type
    • Helps AI agents self-correct when validation fails

Added

• Input Validation System: Comprehensive validation for all MCP tool inputs
  • Created validation-schemas.ts with custom validation utilities
  • No external dependencies - pure TypeScript implementation
  • Tool-specific validation schemas for all MCP tools
  • Clear error messages with field-level details
• Enhanced Cycle Detection: Improved detection of legitimate loops vs actual cycles
  • Recognizes SplitInBatches loop patterns as valid
  • Reduces false positive cycle warnings
• Comprehensive Test Suite: Added 16 tests covering all validation fixes
  • Tests for crash prevention with malformed inputs
  • Tests for profile behavior across validation phases
  • Tests for error recovery suggestions
  • Tests for legitimate loop patterns

Enhanced

• Validation Profiles: Now consistently applied across all validation phases
  • minimal: Reduces warnings for basic validation
  • runtime: Standard validation for production workflows
  • ai-friendly: Optimized for AI agent workflow creation
  • strict: Maximum validation for critical workflows
• Error Messages: More helpful and actionable for both humans and AI agents
  • Specific recovery suggestions for common errors
  • Clear guidance on fixing validation issues
  • Examples of correct configurations

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.10.3

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

Documentation

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

🤖 Generated with Claude Code