6c7033bb45
This major update adds comprehensive n8n integration, enabling n8n-mcp to run as an MCP server within n8n workflows using the MCP Client Tool node. ## Key Features ### n8n Integration (NEW) - Full MCP Client Tool compatibility with protocol version negotiation - Dedicated n8n mode with optimized Docker deployment - Workflow examples and n8n-friendly tool descriptions - Quick deployment script for easy setup ### Protocol & Compatibility - Intelligent protocol version selection (2024-11-05 for n8n, 2025-03-26 for others) - Fixed schema validation issues with n8n's nested output format - Enhanced parameter validation with clear error messages - Comprehensive test suite for protocol negotiation ### Security Enhancements - Dynamic UID/GID generation (10000-59999) for Docker containers - Improved error sanitization for production environments - Fixed information leakage in error responses - Enhanced permission handling for mounted volumes ### Performance Optimizations - Docker build time reduced from 13+ minutes to 1-2 minutes - Image size reduced from ~1.5GB to ~280MB - Fixed ARM64 build failures - Optimized to use runtime-only dependencies ### Developer Experience - Comprehensive parameter validation for all MCP tools - Made README version badge dynamic from package.json - Enhanced test coverage with session management tests - Improved CI/CD with informational patch coverage ### Documentation - Added comprehensive N8N_DEPLOYMENT.md guide - Updated CHANGELOG.md for version 2.9.0 - Enhanced CLAUDE.md with n8n-specific instructions - Added deployment scripts and examples ## Technical Details Files Added: - Dockerfile.n8n, docker-compose.n8n.yml for n8n deployment - Protocol version negotiation utilities - n8n integration test suite - Session management tests - Deployment and test scripts - Version badge update scripts Files Modified: - Enhanced MCP server with n8n mode support - Improved HTTP server with better error handling - Updated Docker configurations for security - Enhanced logging for n8n compatibility - CHANGELOG.md with comprehensive update description This update makes n8n-mcp a first-class citizen in the n8n ecosystem, enabling powerful AI-assisted workflow automation. 🤖 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.