- Add intelligent URL detection supporting BASE_URL, PUBLIC_URL, and proxy headers - Fix hardcoded localhost URLs in server console output - Add hostname validation to prevent host header injection attacks - Restrict URL schemes to http/https only (block javascript:, file://, etc.) - Remove sensitive environment data from API responses - Add GET endpoints (/, /mcp) for better API discovery - Fix version inconsistency between server implementations - Update HTTP bridge to use HOST/PORT environment variables - Add comprehensive test scripts for URL configuration and security This resolves issues #41 and #42 by making the HTTP server properly handle deployment behind reverse proxies and adds critical security validations. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
658 lines
31 KiB
Markdown
658 lines
31 KiB
Markdown
# Changelog
|
|
|
|
All notable changes to this project will be documented in this file.
|
|
|
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
|
## [2.7.15] - 2025-07-15
|
|
|
|
### Fixed
|
|
- **HTTP Server URL Handling**: Fixed hardcoded localhost URLs in HTTP server output (Issue #41, #42)
|
|
- Added intelligent URL detection that considers BASE_URL, PUBLIC_URL, and proxy headers
|
|
- Server now displays correct public URLs when deployed behind reverse proxies
|
|
- Added support for X-Forwarded-Proto and X-Forwarded-Host headers when TRUST_PROXY is enabled
|
|
- Fixed port display logic to hide standard ports (80/443) in URLs
|
|
- Added new GET endpoints (/, /mcp) for better API discovery
|
|
|
|
### Security
|
|
- **Host Header Injection Prevention**: Added hostname validation to prevent malicious proxy headers
|
|
- Only accepts valid hostnames (alphanumeric, dots, hyphens, optional port)
|
|
- Rejects hostnames with paths, usernames, or special characters
|
|
- Falls back to safe defaults when invalid headers are detected
|
|
- **URL Scheme Validation**: Restricted URL schemes to http/https only
|
|
- Blocks dangerous schemes like javascript:, file://, data:
|
|
- Validates all configured URLs (BASE_URL, PUBLIC_URL)
|
|
- **Information Disclosure**: Removed sensitive environment data from API responses
|
|
- Root endpoint no longer exposes internal configuration
|
|
- Only shows essential API information
|
|
|
|
### Added
|
|
- **URL Detection Utility**: New `url-detector.ts` module for intelligent URL detection
|
|
- Prioritizes explicit configuration (BASE_URL/PUBLIC_URL)
|
|
- Falls back to proxy headers when TRUST_PROXY is enabled
|
|
- Uses host/port configuration as final fallback
|
|
- Includes comprehensive security validations
|
|
- **Test Scripts**: Added test scripts for URL configuration and security validation
|
|
- `test-url-configuration.ts`: Tests various URL detection scenarios
|
|
- `test-security.ts`: Validates security fixes for malicious headers
|
|
|
|
### Changed
|
|
- **Consistent Versioning**: Fixed version inconsistency between server implementations
|
|
- Both http-server.ts and http-server-single-session.ts now use PROJECT_VERSION
|
|
- Removed hardcoded version strings
|
|
- **HTTP Bridge**: Updated to use HOST/PORT environment variables for default URL construction
|
|
- **Documentation**: Updated HTTP deployment guide with URL configuration section
|
|
|
|
## [2.7.14] - 2025-07-15
|
|
|
|
### Fixed
|
|
- **Partial Update Tool**: Fixed validation/execution discrepancy that caused "settings must NOT have additional properties" error (Issue #45)
|
|
- Removed logic in `cleanWorkflowForUpdate` that was incorrectly adding default settings to workflows
|
|
- The function now only removes read-only fields without adding any new properties
|
|
- This fixes the issue where partial updates would pass validation but fail during execution
|
|
- Added comprehensive test coverage in `test-issue-45-fix.ts`
|
|
|
|
## [2.7.13] - 2025-07-11
|
|
|
|
### Fixed
|
|
- **npx Execution**: Fixed WASM file resolution for sql.js when running via `npx n8n-mcp` (Issue #31)
|
|
- Enhanced WASM file locator to try multiple path resolution strategies
|
|
- Added `require.resolve()` for reliable package location in npm environments
|
|
- Made better-sqlite3 an optional dependency to prevent installation failures
|
|
- Improved error messages when sql.js fails to load
|
|
- The package now works correctly with `npx` without any manual configuration
|
|
|
|
### Changed
|
|
- **Database Adapter**: Improved path resolution for both local development and npm package contexts
|
|
- Supports various npm installation scenarios (global, local, npx cache)
|
|
- Better fallback handling for sql.js WebAssembly file loading
|
|
|
|
## [2.7.12] - 2025-07-10
|
|
|
|
### Updated
|
|
- **n8n Dependencies**: Updated to latest versions for compatibility and new features
|
|
- n8n: 1.100.1 → 1.101.1
|
|
- n8n-core: 1.99.0 → 1.100.0
|
|
- n8n-workflow: 1.97.0 → 1.98.0
|
|
- @n8n/n8n-nodes-langchain: 1.99.0 → 1.100.1
|
|
- **Node Database**: Rebuilt with 528 nodes from updated n8n packages
|
|
- All validation tests passing with updated dependencies
|
|
|
|
## [2.7.11] - 2025-07-10
|
|
|
|
### Enhanced
|
|
- **Token Efficiency**: Significantly reduced MCP tool description lengths for better AI agent performance
|
|
- Documentation tools: Average 129 chars (down from ~250-450)
|
|
- Management tools: Average 93 chars (down from ~200-400)
|
|
- Overall token reduction: ~65-70%
|
|
- Moved detailed documentation to `tools_documentation()` system
|
|
- Only 2 tools exceed 200 chars (list_nodes: 204, n8n_update_partial_workflow: 284)
|
|
- Preserved all essential information while removing redundancy
|
|
|
|
### Fixed
|
|
- **search_nodes Tool**: Major improvements to search functionality for AI agents
|
|
- Primary nodes (webhook, httpRequest) now appear first in search results instead of being buried
|
|
- Fixed issue where searching "webhook" returned specialized triggers instead of the main Webhook node
|
|
- Fixed issue where searching "http call" didn't prioritize HTTP Request node
|
|
- Fixed FUZZY mode returning no results for typos like "slak" (lowered threshold from 300 to 200)
|
|
- Removed unnecessary searchInfo messages that appeared on every search
|
|
- Fixed HTTP node type comparison case sensitivity issue
|
|
- Implemented relevance-based ranking with special boosting for primary nodes
|
|
- **search_templates FTS5 Error**: Fixed "no such module: fts5" error in environments without FTS5 support (fixes Claude Desktop issue)
|
|
- Made FTS5 completely optional - detects support at runtime
|
|
- Removed FTS5 from required schema to prevent initialization failures
|
|
- Automatically falls back to LIKE search when FTS5 is unavailable
|
|
- FTS5 tables and triggers created conditionally only if supported
|
|
- Template search now works in ALL SQLite environments
|
|
|
|
### Added
|
|
- **FTS5 Full-Text Search**: Added SQLite FTS5 support for faster and more intelligent node searching
|
|
- Automatic fallback to LIKE queries if FTS5 is unavailable
|
|
- Supports advanced search modes: OR (default), AND (all terms required), FUZZY (typo-tolerant)
|
|
- Significantly improves search performance for large databases
|
|
- FUZZY mode now uses edit distance (Levenshtein) for better typo tolerance
|
|
- **FTS5 Detection**: Added runtime detection of FTS5 support
|
|
- `checkFTS5Support()` method in database adapters
|
|
- Conditional initialization of FTS5 features
|
|
- Graceful degradation when FTS5 not available
|
|
|
|
## [Unreleased]
|
|
|
|
### Fixed
|
|
- **Code Node Documentation**: Corrected information about `$helpers` object and `getWorkflowStaticData` function
|
|
- `$getWorkflowStaticData()` is a standalone function, NOT `$helpers.getWorkflowStaticData()`
|
|
- Updated Code node guide to clarify which functions are standalone vs methods on $helpers
|
|
- Added validation warning when using incorrect `$helpers.getWorkflowStaticData` syntax
|
|
- Based on n8n community feedback and GitHub issues showing this is a common confusion point
|
|
|
|
### Added
|
|
- **Expression vs Code Node Clarification**: Added comprehensive documentation about differences between expression and Code node contexts
|
|
- New section "IMPORTANT: Code Node vs Expression Context" explaining key differences
|
|
- Lists expression-only functions not available in Code nodes ($now(), $today(), Tournament template functions)
|
|
- Clarifies different syntax: $('Node Name') vs $node['Node Name']
|
|
- Documents reversed JMESPath parameter order between contexts
|
|
- Added "Expression Functions NOT in Code Nodes" section with alternatives
|
|
- **Enhanced Code Node Validation**: Added new validation checks for common expression/Code node confusion
|
|
- Detects expression syntax {{...}} in Code nodes with clear error message
|
|
- Warns about using $node[] syntax instead of $() in Code nodes
|
|
- Identifies expression-only functions with helpful alternatives
|
|
- Checks for wrong JMESPath parameter order
|
|
- Test script `test-expression-code-validation.ts` to verify validation works correctly
|
|
|
|
## [2.7.11] - 2025-07-09
|
|
|
|
### Fixed
|
|
- **Issue #26**: Fixed critical issue where AI agents were placing error handling properties inside `parameters` instead of at node level
|
|
- Root cause: AI agents were confused by examples showing `parameters.path` updates and assumed all properties followed the same pattern
|
|
- Error handling properties (`onError`, `retryOnFail`, `maxTries`, `waitBetweenTries`, `alwaysOutputData`) must be placed at the NODE level
|
|
- Other node-level properties (`executeOnce`, `disabled`, `notes`, `notesInFlow`, `credentials`) were previously undocumented for AI agents
|
|
- Updated `n8n_create_workflow` and `n8n_update_partial_workflow` documentation with explicit examples and warnings
|
|
- Verified fix with workflows tGyHrsBNWtaK0inQ, usVP2XRXhI35m3Ts, and swuogdCCmNY7jj71
|
|
|
|
### Added
|
|
- **Comprehensive Node-Level Properties Reference** in tools documentation (`tools_documentation()`)
|
|
- Documents ALL available node-level properties with explanations
|
|
- Shows correct placement and usage for each property
|
|
- Provides complete example node configuration
|
|
- Accessible via `tools_documentation({depth: "full"})` for AI agents
|
|
- **Enhanced Workflow Validation** for additional node-level properties
|
|
- Now validates `executeOnce`, `disabled`, `notes`, `notesInFlow` types
|
|
- Checks for misplacement of ALL node-level properties (expanded from 6 to 11)
|
|
- Provides clear error messages with correct examples when properties are misplaced
|
|
- Shows specific fix with example node structure
|
|
- **Test Script** `test-node-level-properties.ts` demonstrating correct usage
|
|
- Shows all node-level properties in proper configuration
|
|
- Demonstrates common mistakes to avoid
|
|
- Validates workflow configurations
|
|
- **Comprehensive Code Node Documentation** in tools_documentation
|
|
- New `code_node_guide` topic with complete reference for JavaScript and Python
|
|
- Covers all built-in variables: $input, $json, $node, $workflow, $execution, $prevNode
|
|
- Documents helper functions: DateTime (Luxon), JMESPath, $helpers methods
|
|
- Includes return format requirements with correct/incorrect examples
|
|
- Security considerations and banned operations
|
|
- Common patterns: data transformation, filtering, aggregation, error handling
|
|
- Code node as AI tool examples
|
|
- Performance best practices and debugging tips
|
|
- **Enhanced Code Node Validation** with n8n-specific patterns
|
|
- Validates return statement presence and format
|
|
- Checks for array of objects with json property
|
|
- Detects common mistakes (returning primitives, missing array wrapper)
|
|
- Validates n8n variable usage ($input, items, $json context)
|
|
- Security checks (eval, exec, require, file system access)
|
|
- Language-specific validation for JavaScript and Python
|
|
- Mode-specific warnings ($json in wrong mode)
|
|
- Async/await pattern validation
|
|
- External library detection with helpful alternatives
|
|
- **Expanded Code Node Examples** in ExampleGenerator
|
|
- Data transformation, aggregation, and filtering examples
|
|
- API integration with error handling
|
|
- Python data processing example
|
|
- Code node as AI tool pattern
|
|
- CSV to JSON transformation
|
|
- All examples include proper return format
|
|
- **New Code Node Task Templates**
|
|
- `custom_ai_tool`: Create custom tools for AI agents
|
|
- `aggregate_data`: Summary statistics from multiple items
|
|
- `batch_process_with_api`: Process items in batches with rate limiting
|
|
- `error_safe_transform`: Robust data transformation with validation
|
|
- `async_data_processing`: Concurrent processing with limits
|
|
- `python_data_analysis`: Statistical analysis using Python
|
|
- All templates include comprehensive error handling
|
|
- **Fixed Misleading Documentation** based on real-world testing:
|
|
- **Crypto Module**: Clarified that `require('crypto')` IS available despite editor warnings
|
|
- **Helper Functions**: Fixed documentation showing `$getWorkflowStaticData()` is standalone, not on $helpers
|
|
- **JMESPath**: Corrected syntax from `jmespath.search()` to `$jmespath()`
|
|
- **Node Access**: Fixed from `$node['Node Name']` to `$('Node Name')`
|
|
- **Python**: Documented `item.json.to_py()` for JsProxy conversion
|
|
- Added comprehensive "Available Functions and Libraries" section
|
|
- Created security examples showing proper crypto usage
|
|
- **JMESPath Numeric Literals**: Added critical documentation about n8n-specific requirement for backticks around numbers in filters
|
|
- Example: `[?age >= \`18\`]` not `[?age >= 18]`
|
|
- Added validation to detect and warn about missing backticks
|
|
- Based on Claude Desktop feedback from workflow testing
|
|
- **Webhook Data Structure**: Fixed common webhook data access gotcha
|
|
- Webhook payload is at `items[0].json.body`, NOT `items[0].json`
|
|
- Added dedicated "Webhook Data Access" section in Code node documentation
|
|
- Created webhook processing example showing correct data access
|
|
- Added validation to detect incorrect webhook data access patterns
|
|
- New task template `process_webhook_data` with complete example
|
|
|
|
### Enhanced
|
|
- **MCP Tool Documentation** significantly improved:
|
|
- `n8n_create_workflow` now includes complete node example with all properties
|
|
- `n8n_update_partial_workflow` shows difference between node-level vs parameter updates
|
|
- Added "CRITICAL" warnings about property placement
|
|
- Updated best practices and common pitfalls sections
|
|
- **Workflow Validator** improvements:
|
|
- Expanded property checking from 6 to 11 node-level properties
|
|
- Better error messages showing complete correct structure
|
|
- Type validation for all node-level boolean and string properties
|
|
- **Code Node Validation** enhanced with new checks:
|
|
- Detects incorrect `$helpers.getWorkflowStaticData()` usage
|
|
- Warns about `$helpers` usage without availability check
|
|
- Validates crypto usage with proper require statement
|
|
- All based on common errors found in production workflows
|
|
- **Type Definitions** updated:
|
|
- Added `notesInFlow` to WorkflowNode interface in workflow-validator.ts
|
|
- Fixed credentials type from `Record<string, string>` to `Record<string, unknown>` in n8n-api.ts
|
|
- **NodeSpecificValidators** now includes comprehensive Code node validation
|
|
- Language-specific syntax checks
|
|
- Return format validation with detailed error messages
|
|
- n8n variable usage validation
|
|
- Security pattern detection
|
|
- Error handling recommendations
|
|
- Mode-specific suggestions
|
|
- **Config Validator** improved Code node validation
|
|
- Better return statement detection
|
|
- Enhanced syntax checking for both JavaScript and Python
|
|
- More helpful error messages with examples
|
|
- Detection of common n8n Code node mistakes
|
|
- **Fixed Documentation Inaccuracies** based on user testing and n8n official docs:
|
|
- JMESPath: Corrected syntax to `$jmespath()` instead of `jmespath.search()`
|
|
- Node Access: Fixed to show `$('Node Name')` syntax, not `$node`
|
|
- Python: Documented `_input.all()` and `item.json.to_py()` for JsProxy conversion
|
|
- Python: Added underscore prefix documentation for all built-in variables
|
|
- Validation: Skip property visibility warnings for Code nodes to reduce false positives
|
|
|
|
## [2.7.10] - 2025-07-09
|
|
|
|
### Documentation Update
|
|
- Added comprehensive documentation on how to update error handling properties using `n8n_update_partial_workflow`
|
|
- Error handling properties can be updated at the node level using the workflow diff engine:
|
|
- `continueOnFail`: boolean - Whether to continue workflow on node failure
|
|
- `onError`: 'continueRegularOutput' | 'continueErrorOutput' | 'stopWorkflow' - Error handling strategy
|
|
- `retryOnFail`: boolean - Whether to retry on failure
|
|
- `maxTries`: number - Maximum retry attempts
|
|
- `waitBetweenTries`: number - Milliseconds to wait between retries
|
|
- `alwaysOutputData`: boolean - Always output data even on error
|
|
- Added test script demonstrating error handling property updates
|
|
- Updated WorkflowNode type to include `onError` property in n8n-api types
|
|
- Workflow diff engine now properly handles all error handling properties
|
|
|
|
## [2.7.10] - 2025-07-07
|
|
|
|
### Added
|
|
- Enhanced authentication logging for better debugging of client authentication issues
|
|
- Specific error reasons for authentication failures: `no_auth_header`, `invalid_auth_format`, `invalid_token`
|
|
- AUTH_TOKEN_FILE support in single-session HTTP server for consistency
|
|
- Empty token validation to prevent security issues
|
|
- Whitespace trimming for authentication tokens
|
|
|
|
### Fixed
|
|
- Issue #22: Improved authentication failure diagnostics for mcp-remote client debugging
|
|
- Issue #16: Fixed AUTH_TOKEN_FILE validation for HTTP mode in Docker production stacks - Docker entrypoint now properly validates and supports AUTH_TOKEN_FILE environment variable
|
|
- Security: Removed token length from logs to prevent information disclosure
|
|
|
|
### Security
|
|
- Authentication tokens are now trimmed to handle whitespace edge cases
|
|
- Empty tokens are explicitly rejected with clear error messages
|
|
- Removed sensitive information (token lengths) from authentication logs
|
|
|
|
## [2.7.8] - 2025-07-06
|
|
|
|
### Added
|
|
- npx support for zero-installation usage - users can now run `npx n8n-mcp` without installing
|
|
- npm package distribution with runtime-only dependencies (8 deps vs 50+ dev deps)
|
|
- Dedicated publish script for npm releases with OTP support
|
|
- Database path resolution supporting npx, global, and local installations
|
|
|
|
### Fixed
|
|
- Issue #15: Added npx execution support as requested
|
|
- Removed development dependencies from npm package (reduced from 1GB+ to ~50MB)
|
|
- Node.js version conflicts by excluding n8n dependencies from runtime package
|
|
|
|
### Changed
|
|
- npm package now uses package.runtime.json for publishing (no n8n dependencies)
|
|
- Enhanced .gitignore to exclude npm publishing artifacts
|
|
- README now highlights npx as the primary installation method
|
|
|
|
## [2.7.5] - 2025-07-06
|
|
|
|
### Added
|
|
- AUTH_TOKEN_FILE support for reading authentication tokens from files (Docker secrets compatible) - partial implementation
|
|
- Known Issues section in README documenting Claude Desktop container duplication bug
|
|
- Enhanced authentication documentation in Docker README
|
|
|
|
### Fixed
|
|
- Issue #16: AUTH_TOKEN_FILE was documented but not implemented (partially fixed - see v2.7.10 for complete fix)
|
|
- HTTP server now properly supports both AUTH_TOKEN and AUTH_TOKEN_FILE environment variables
|
|
|
|
### Changed
|
|
- Authentication logic now checks AUTH_TOKEN first, then falls back to AUTH_TOKEN_FILE
|
|
- Updated Docker documentation to clarify authentication options
|
|
|
|
## [2.7.4] - 2025-07-03
|
|
|
|
### Changed
|
|
- Renamed `start_here_workflow_guide` tool to `tools_documentation` for better clarity
|
|
- Converted tool output from JSON to LLM-friendly plain text format
|
|
- Made documentation concise by default with "essentials" depth
|
|
|
|
### Added
|
|
- `depth` parameter to control documentation detail level ("essentials" or "full")
|
|
- Per-tool documentation - get help for any specific MCP tool
|
|
- Two-tier documentation system:
|
|
- Essentials: Brief description, key parameters, example, performance, tips
|
|
- Full: Complete documentation with all details, examples, best practices
|
|
- Quick reference mode when called without parameters
|
|
- Documentation for 8 commonly used tools
|
|
- Test script for tools documentation (`test:tools-documentation`)
|
|
|
|
### Removed
|
|
- Removed duplicate `tools_documentation` tool definition
|
|
- Removed unused `getWorkflowGuide` method (380+ lines)
|
|
- Removed old `handlers-documentation.ts` file
|
|
|
|
## [2.7.3] - 2025-07-02
|
|
|
|
### Added
|
|
- MCP Tools Documentation system (initial implementation)
|
|
- `tools_documentation` tool for comprehensive MCP tool documentation
|
|
- Documentation includes parameters, examples, best practices, and pitfalls
|
|
- Search tools by keyword functionality
|
|
- Browse tools by category
|
|
- Quick reference guide with workflow patterns
|
|
|
|
### Fixed
|
|
- Cleaned up redundant tool definitions
|
|
|
|
## [2.7.2] - 2025-07-01
|
|
|
|
### Fixed
|
|
- HTTP deployment documentation improvements
|
|
- Docker configuration updates with n8n API options
|
|
|
|
### Changed
|
|
- Updated version handling in multiple configuration files
|
|
|
|
## [2.7.1] - 2025-06-30
|
|
|
|
### Fixed
|
|
- Workflow diff engine edge cases
|
|
- Transactional update processing improvements
|
|
|
|
### Added
|
|
- Additional test coverage for diff operations
|
|
- Debug scripts for update operations
|
|
|
|
## [2.7.0] - 2025-06-29
|
|
|
|
### Added
|
|
- New `n8n_update_partial_workflow` tool for efficient diff-based workflow editing with transactional updates
|
|
- WorkflowDiffEngine for applying targeted edits without sending full workflow JSON (80-90% token savings)
|
|
- 13 diff operations: addNode, removeNode, updateNode, moveNode, enableNode, disableNode, addConnection, removeConnection, updateConnection, updateSettings, updateName, addTag, removeTag
|
|
- Smart node references supporting both node ID and name
|
|
- Transaction safety with validation before applying changes
|
|
- Validation-only mode for testing diff operations
|
|
- Comprehensive test coverage for all diff operations
|
|
- Example guide in `docs/workflow-diff-examples.md`
|
|
- Two-pass processing allowing operations in any order
|
|
- Operation limit of 5 operations per request for reliability
|
|
- `n8n_diagnostic` tool to troubleshoot management tools visibility issues
|
|
- Version utility (`src/utils/version.ts`) for centralized version management
|
|
- Script to sync package.runtime.json version
|
|
|
|
### Changed
|
|
- Renamed `n8n_update_workflow` to `n8n_update_full_workflow` to clarify it replaces entire workflow
|
|
- Renamed core MCP files for clarity:
|
|
- `tools-update.ts` → `tools.ts`
|
|
- `server-update.ts` → `server.ts`
|
|
- `http-server-fixed.ts` → `http-server.ts`
|
|
- Updated imports across 21+ files to use new file names
|
|
|
|
### Fixed
|
|
- Version mismatch issue where version was hardcoded instead of reading from package.json (GitHub issue #5)
|
|
- MCP validation error by simplifying schema to allow additional properties
|
|
- n8n API validation by removing all read-only fields in cleanWorkflowForUpdate
|
|
- Claude Desktop compatibility by adding additionalProperties: true
|
|
- Removed DEBUG console.log statements from MCP server
|
|
|
|
### Removed
|
|
- Legacy HTTP server implementation (`src/http-server.ts`)
|
|
- Unused legacy API client (`src/utils/n8n-client.ts`)
|
|
- Unnecessary file name suffixes (-update, -fixed)
|
|
|
|
## [2.6.3] - 2025-06-26
|
|
|
|
### Added
|
|
- `n8n_validate_workflow` tool to validate workflows directly from n8n instance by ID
|
|
- Fetches workflow from n8n API and runs comprehensive validation
|
|
- Supports all validation profiles and options
|
|
- Part of complete lifecycle: discover → build → validate → deploy → execute
|
|
|
|
## [2.6.2] - 2025-06-26
|
|
|
|
### Added
|
|
- Node type validation to verify node types exist in n8n
|
|
- Smart suggestions for common mistakes (e.g., `webhook` → `n8n-nodes-base.webhook`)
|
|
- Minimum viable workflow validation preventing single-node workflows (except webhooks)
|
|
- Empty connection detection for multi-node workflows
|
|
- Helper functions: `getWorkflowStructureExample()` and `getWorkflowFixSuggestions()`
|
|
|
|
### Fixed
|
|
- nodes-base prefix detection now catches errors before database lookup
|
|
- Enhanced error messages with clear guidance on proper workflow structure
|
|
|
|
## [2.6.1] - 2025-06-26
|
|
|
|
### Added
|
|
- typeVersion validation in workflow validator
|
|
- Enforces typeVersion on all versioned nodes
|
|
- Warns on outdated node versions
|
|
- Prevents invalid version numbers
|
|
|
|
### Fixed
|
|
- Missing typeVersion errors with correct version suggestions
|
|
- Invalid version detection exceeding maximum supported
|
|
|
|
## [2.6.0] - 2025-06-26
|
|
|
|
### Added
|
|
- 14 n8n management tools for complete workflow lifecycle management:
|
|
- `n8n_create_workflow` - Create workflows programmatically
|
|
- `n8n_update_workflow` - Update existing workflows
|
|
- `n8n_trigger_webhook_workflow` - Execute workflows via webhooks
|
|
- `n8n_list_executions` - Monitor workflow executions
|
|
- `n8n_health_check` - Check n8n instance connectivity
|
|
- And 9 more workflow and execution management tools
|
|
- Integration with n8n-manager-for-ai-agents functionality
|
|
- Conditional tool registration based on N8N_API_URL and N8N_API_KEY configuration
|
|
- Smart error handling for API limitations
|
|
|
|
## [2.5.1] - 2025-06-24
|
|
|
|
### Added
|
|
- `get_node_as_tool_info` tool for specific information about using ANY node as an AI tool
|
|
- Enhanced AI tool support with usage guidance
|
|
- Improved start_here_workflow_guide with Claude Project setup
|
|
|
|
### Changed
|
|
- Enhanced AI tool detection and documentation
|
|
- Updated documentation to match current state
|
|
|
|
## [2.5.0] - 2025-06-24
|
|
|
|
### Added
|
|
- Comprehensive workflow validation system:
|
|
- `validate_workflow` - Validate entire workflows before deployment
|
|
- `validate_workflow_connections` - Check workflow structure and connections
|
|
- `validate_workflow_expressions` - Validate all n8n expressions
|
|
- Expression validator for n8n syntax validation
|
|
- AI tool connection validation
|
|
- Phase 2 validation improvements
|
|
|
|
## [2.4.2] - 2025-06-24
|
|
|
|
### Added
|
|
- Enhanced operation-aware validation system
|
|
- `validate_node_operation` - Verify node configuration with operation awareness
|
|
- `validate_node_minimal` - Quick validation for required fields only
|
|
- Node-specific validation logic
|
|
- Validation profiles support
|
|
|
|
### Fixed
|
|
- Validation improvements based on AI agent feedback
|
|
|
|
## [2.4.1] - 2025-06-20
|
|
|
|
### Added
|
|
- n8n workflow templates integration:
|
|
- `list_node_templates` - Find workflow templates using specific nodes
|
|
- `get_template` - Get complete workflow JSON for import
|
|
- `search_templates` - Search templates by keywords
|
|
- `get_templates_for_task` - Get curated templates for common tasks
|
|
- Template fetching from n8n.io API
|
|
- Robust template fetching with retries
|
|
- Expanded template window from 6 months to 1 year
|
|
|
|
### Fixed
|
|
- Made templates available in Docker by removing axios from runtime
|
|
- Template service made optional in Docker environment
|
|
- Non-deterministic CHECK constraint removed from templates table
|
|
|
|
## [2.4.0] - 2025-06-18
|
|
|
|
### Added
|
|
- AI-optimized tools with 95% size reduction:
|
|
- `get_node_essentials` - Returns only essential properties (10-20) with examples
|
|
- `search_node_properties` - Find specific properties without downloading everything
|
|
- `get_node_for_task` - Get pre-configured node settings for common tasks
|
|
- `list_tasks` - List all available task templates
|
|
- `get_property_dependencies` - Analyze property dependencies and visibility conditions
|
|
- Property filter service with curated essential properties
|
|
- Example generator for common use cases
|
|
- Task templates with pre-configured settings
|
|
- Docker build optimization (82% smaller images, 10x faster builds)
|
|
|
|
### Changed
|
|
- Switched to MIT license for wider adoption
|
|
- Optimized Docker builds to exclude n8n dependencies at runtime
|
|
- Improved tool descriptions and added workflow guide tool
|
|
|
|
### Fixed
|
|
- Docker build failures in GitHub Actions
|
|
- Claude Desktop stdio communication issues
|
|
- Version array handling in node parser
|
|
|
|
### Removed
|
|
- Legacy MCP implementation files
|
|
- n8n dependencies from Docker runtime image
|
|
|
|
## [2.3.3] - 2025-06-16
|
|
|
|
### Added
|
|
- Smart dependency update system for n8n packages
|
|
- GitHub Actions workflow for automated n8n updates
|
|
- Alternative Renovate configuration
|
|
|
|
### Fixed
|
|
- n8n package interdependent version requirements
|
|
- Node type references in validation script
|
|
|
|
## [2.3.2] - 2025-06-14
|
|
|
|
### Added
|
|
- Single-session HTTP server architecture
|
|
- Direct JSON-RPC implementation for HTTP mode
|
|
- Console output isolation for clean JSON-RPC responses
|
|
|
|
### Fixed
|
|
- "stream is not readable" error in HTTP server
|
|
- "Server not initialized" error with StreamableHTTPServerTransport
|
|
- MCP HTTP server stream errors
|
|
|
|
## [2.3.1] - 2025-06-13
|
|
|
|
### Added
|
|
- HTTP server mode for remote deployment with token authentication
|
|
- MCP-compatible HTTP endpoints
|
|
- Security features: CORS, rate limiting, request size limits
|
|
- Comprehensive HTTP testing scripts
|
|
|
|
## [2.3.0] - 2025-06-12
|
|
|
|
### Added
|
|
- Universal Node.js compatibility with automatic database adapter fallback
|
|
- Database adapter pattern with BetterSQLiteAdapter and SQLJSAdapter
|
|
- Automatic adapter selection based on environment
|
|
- sql.js persistence layer with debounced saves
|
|
|
|
### Changed
|
|
- Database operations now use unified adapter interface
|
|
- Transparent adapter switching for different Node.js versions
|
|
|
|
## [2.2.0] - 2025-06-12
|
|
|
|
### Added
|
|
- Enhanced node parser with versioned node support
|
|
- Dedicated property extractor for complex node structures
|
|
- Full support for @n8n/n8n-nodes-langchain package
|
|
- AI tool detection (35 tools with usableAsTool property)
|
|
|
|
### Changed
|
|
- Major refactor based on IMPLEMENTATION_PLAN.md v2.2
|
|
- Improved property/operation extraction (452/458 nodes have properties)
|
|
- Enhanced documentation mapping
|
|
|
|
### Fixed
|
|
- VersionedNodeType handling
|
|
- Documentation mapping issues
|
|
- Property extraction for 98.7% of nodes
|
|
|
|
## [2.1.0] - 2025-06-09
|
|
|
|
### Added
|
|
- Node extraction scripts for n8n modules
|
|
- Docker setup for n8n module processing
|
|
- Enhanced documentation fetcher
|
|
- Node source extractor utility
|
|
|
|
## [2.0.0] - 2025-06-08
|
|
|
|
### Added
|
|
- Complete overhaul to enhanced documentation-only MCP server
|
|
- SQLite database with FTS5 for fast searching
|
|
- Comprehensive MCP tools for querying n8n nodes
|
|
- Node documentation service as core component
|
|
|
|
### Changed
|
|
- Architecture redesign focusing on documentation serving
|
|
- Removed workflow execution capabilities
|
|
- Simplified to documentation and knowledge serving
|
|
|
|
## [1.0.0] - 2025-06-08
|
|
|
|
### Added
|
|
- Initial release
|
|
- Basic n8n and MCP integration
|
|
- Core workflow automation features
|
|
|
|
[2.7.13]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.12...v2.7.13
|
|
[2.7.12]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.11...v2.7.12
|
|
[2.7.11]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.10...v2.7.11
|
|
[2.7.10]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.8...v2.7.10
|
|
[2.7.8]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.5...v2.7.8
|
|
[2.7.5]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.4...v2.7.5
|
|
[2.7.4]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.3...v2.7.4
|
|
[2.7.3]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.2...v2.7.3
|
|
[2.7.2]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.1...v2.7.2
|
|
[2.7.1]: https://github.com/czlonkowski/n8n-mcp/compare/v2.7.0...v2.7.1
|
|
[2.7.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.6.3...v2.7.0
|
|
[2.6.3]: https://github.com/czlonkowski/n8n-mcp/compare/v2.6.2...v2.6.3
|
|
[2.6.2]: https://github.com/czlonkowski/n8n-mcp/compare/v2.6.1...v2.6.2
|
|
[2.6.1]: https://github.com/czlonkowski/n8n-mcp/compare/v2.6.0...v2.6.1
|
|
[2.6.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.5.1...v2.6.0
|
|
[2.5.1]: https://github.com/czlonkowski/n8n-mcp/compare/v2.5.0...v2.5.1
|
|
[2.5.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.4.2...v2.5.0
|
|
[2.4.2]: https://github.com/czlonkowski/n8n-mcp/compare/v2.4.1...v2.4.2
|
|
[2.4.1]: https://github.com/czlonkowski/n8n-mcp/compare/v2.4.0...v2.4.1
|
|
[2.4.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.3.3...v2.4.0
|
|
[2.3.3]: https://github.com/czlonkowski/n8n-mcp/compare/v2.3.2...v2.3.3
|
|
[2.3.2]: https://github.com/czlonkowski/n8n-mcp/compare/v2.3.1...v2.3.2
|
|
[2.3.1]: https://github.com/czlonkowski/n8n-mcp/compare/v2.3.0...v2.3.1
|
|
[2.3.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.2.0...v2.3.0
|
|
[2.2.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.1.0...v2.2.0
|
|
[2.1.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.0.0...v2.1.0
|
|
[2.0.0]: https://github.com/czlonkowski/n8n-mcp/compare/v1.0.0...v2.0.0
|
|
[1.0.0]: https://github.com/czlonkowski/n8n-mcp/releases/tag/v1.0.0 |