Major improvements based on comprehensive test suite review: Test Fixes: - Fix all 78 failing tests across logger, MSW, and validator tests - Fix console spy management in logger tests with proper DEBUG env handling - Fix MSW test environment restoration in session-management.test.ts - Fix workflow validator tests by adding proper node connections - Fix mock setup issues in edge case tests Test Organization: - Split large config-validator.test.ts (1,075 lines) into 4 focused files - Rename 63+ tests to follow "should X when Y" naming convention - Add comprehensive edge case test files for all major validators - Create tests/README.md with testing guidelines and best practices New Features: - Add ConfigValidator.validateBatch() method for bulk validation - Add edge case coverage for null/undefined, boundaries, invalid data - Add CI-aware performance test timeouts - Add JSDoc comments to test utilities and factories - Add workflow duplicate node name validation tests Results: - All tests passing: 1,356 passed, 19 skipped - Test coverage: 85.34% statements, 85.3% branches - From 78 failures to 0 failures 🤖 Generated with [Claude Code](https://claude.ai/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.