mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-01-30 14:32:04 +00:00
2cb264fd56
- Add ConsoleManager to prevent console output interference with StreamableHTTPServerTransport - Implement SingleSessionHTTPServer with persistent session reuse - Create N8NMCPEngine for clean service integration - Add automatic session expiry after 30 minutes of inactivity - Update logger to be HTTP-aware during active requests - Maintain backward compatibility with existing deployments This fixes the "stream is not readable" error by implementing the Hybrid Single-Session architecture as documented in MCP_ERROR_FIX_PLAN.md 🤖 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 - All installation methods including Docker, manual, and development setup
- Claude Desktop Setup - Configure Claude Desktop to use n8n-MCP
- 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 - Comprehensive Docker deployment guide
- Docker Optimization Guide - Optimized Docker build (200MB vs 2.6GB)
- Docker Testing Results - Docker implementation test results and findings
Development
- Implementation Plan - Technical implementation details
- HTTP Implementation Guide - HTTP server implementation details
- Development Setup - Set up development environment
- Release Guide - How to create releases and manage Docker tags
Reference
- Troubleshooting Guide - Solutions for common issues
- API Reference - MCP tools and API documentation (if available)
- Environment Variables - Configuration options
🚀 Quick Links
For Users
- First Time Setup: Start with the Installation Guide
- Claude Desktop Users: Follow Claude Desktop Setup
- Remote Deployment: See HTTP Deployment Guide
For Developers
- Local Development: See Development Setup
- Docker Development: Check Docker README
- Contributing: Read the implementation plans and guides
🐳 Docker Quick Start
# Quick start with Docker
echo "AUTH_TOKEN=$(openssl rand -base64 32)" > .env
docker compose up -d
# Check health
curl http://localhost:3000/health
📖 Documentation Updates
This documentation is actively maintained. Recent updates include:
- ✅ Docker deployment support (Phase 1 complete)
- ✅ Simplified installation process
- ✅ Enhanced troubleshooting guide
- ✅ Multiple deployment options
🤝 Getting Help
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Troubleshooting: Troubleshooting Guide
📝 License
This project is licensed under the Sustainable Use License. See LICENSE for details.