mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-01-30 06:22:04 +00:00
a66cb18cce
Fixed cryptic "Cannot read properties of undefined (reading 'name')" error when
users mistakenly use 'changes' instead of 'updates' in updateNode operations.
Changes:
- Added early validation in validateUpdateNode() to detect common parameter mistake
- Provides clear, educational error messages with examples
- Fixed outdated documentation example in VS_CODE_PROJECT_SETUP.md
- Added comprehensive test coverage (2 test cases)
Error Messages:
- Before: "Diff engine error: Cannot read properties of undefined (reading 'name')"
- After: "Invalid parameter 'changes'. The updateNode operation requires 'updates'
(not 'changes'). Example: {type: "updateNode", nodeId: "abc", updates: {...}}"
Testing:
- Test coverage: 85% confidence (production ready)
- n8n-mcp-tester: All 3 test cases passed
- Code review: Approved with minor optional suggestions
Impact:
- AI agents now receive actionable error messages
- Self-correction enabled through clear examples
- Zero breaking changes (backward compatible)
- Follows existing patterns from Issue #249
Files Modified:
- src/services/workflow-diff-engine.ts (10 lines added)
- docs/VS_CODE_PROJECT_SETUP.md (1 line fixed)
- tests/unit/services/workflow-diff-engine.test.ts (2 tests added)
- CHANGELOG.md (comprehensive entry)
- package.json (version bump to 2.22.12)
Fixes #392
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
n8n-MCP Documentation
Welcome to the n8n-MCP documentation. This directory contains comprehensive guides for installation, configuration, and troubleshooting.
📚 Documentation Index
Getting Started
- Installation Guide - Comprehensive installation guide covering all methods
- Claude Desktop Setup - Step-by-step guide for Claude Desktop configuration
- Quick Start Tutorial - Basic overview and quick start instructions
Deployment
- HTTP Deployment Guide - Deploy n8n-MCP as an HTTP server for remote access
- Docker Deployment - Complete Docker deployment and configuration guide
- Release Guide - How to create releases and manage Docker tags
Reference
- Troubleshooting Guide - Solutions for common issues and errors
- HTTP Server Fix Documentation - Technical details of v2.3.2 HTTP server fixes
- Docker Optimization Guide - Reference for optimized Docker builds (~150MB)
- Changelog - Version history and release notes
🚀 Quick Links
For Users
For Developers
📋 Environment Variables
Key configuration options:
| Variable | Description | Default |
|---|---|---|
MCP_MODE |
Server mode: stdio or http |
stdio |
USE_FIXED_HTTP |
Use fixed HTTP implementation (v2.3.2+) | true |
AUTH_TOKEN |
Authentication token for HTTP mode | Required |
PORT |
HTTP server port | 3000 |
LOG_LEVEL |
Logging verbosity | info |
See Installation Guide for complete list.
🆘 Getting Help
- Check the Troubleshooting Guide
- Review HTTP Server Fix Documentation for v2.3.2 issues
- Open an issue on GitHub
📝 License
This project uses the Sustainable Use License. See LICENSE for details.