mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-03-17 16:03:08 +00:00
9e1a4129c0
Implements comprehensive workflow creation tests against real n8n instance with 15 test scenarios covering P0 bugs, base nodes, advanced features, error scenarios, and edge cases. Key Changes: - Added 15 workflow creation test scenarios in create-workflow.test.ts - Fixed critical MSW interference with real API calls - Fixed environment loading priority (.env before test defaults) - Implemented multi-level cleanup with webhook workflow preservation - Migrated from webhook IDs to webhook URLs configuration - Added TypeScript type safety fixes (26 errors resolved) - Updated test names to reflect actual n8n API behavior Bug Fixes: - Removed MSW from integration test setup (was blocking real API calls) - Fixed .env loading order to preserve real credentials over test defaults - Added type guards for undefined workflow IDs - Fixed position arrays to use proper tuple types [number, number] - Added literal types for executionOrder and settings values Test Coverage: - P0: Critical bug verification (FULL vs SHORT node type format) - P1: Base n8n nodes (webhook, HTTP, langchain, multi-node) - P2: Advanced features (connections, settings, expressions, error handling) - Error scenarios (documents actual n8n API validation behavior) - Edge cases (minimal workflows, empty connections, no settings) Technical Improvements: - Cleanup strategy preserves pre-activated webhook workflows - Single webhook URL accepts all HTTP methods (GET, POST, PUT, DELETE) - Environment-aware credential loading with validation - Comprehensive test context for resource tracking All 15 tests passing ✅ TypeScript: 0 errors ✅ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
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.