enhanced-n8n-mcp-server/README.md

Enhanced n8n MCP Server with 20 comprehensive improvements for AI-powered workflow management, debugging, and optimization

# Enhanced n8n MCP Server v4.0.0

🚀 **Professional-grade n8n workflow management with AI-powered insights**

## Overview

The Enhanced n8n MCP Server transforms basic n8n integration into a comprehensive workflow management platform with 20 advanced enhancements for AI assistants.

## Key Features

### 🔍 **Advanced Debugging & Analysis**
- **Enhanced Execution Details** - Deep node-level analysis with performance metrics
- **Comprehensive Error Analysis** - Root cause identification with automated solutions
- **Real-Time Monitoring** - Live execution tracking and metrics collection
- **Performance Bottleneck Detection** - Optimization recommendations

### 🏗️ **Intelligent Workflow Management**
- **Template-Based Creation** - Pre-built templates for OCR, API, and data processing
- **Comprehensive Validation** - Multi-layer validation with security checks
- **Auto-Configuration** - Automated setup for popular services
- **Node Suggestions** - AI-powered next-node recommendations

### 🔐 **Professional Security & Monitoring**
- **Credential Health Monitoring** - OAuth2 testing and expiry alerts
- **Resource Usage Analytics** - Memory, CPU, and network monitoring
- **Enhanced Caching** - Multi-layer caching with intelligent invalidation
- **Advanced Error Handling** - Structured error classification and recovery
## Quick Start

### Installation

```bash
npm install enhanced-n8n-mcp-server
```

### Configuration

```bash
# Required environment variables
N8N_API_KEY=your_n8n_api_key
N8N_BASE_URL=https://your-n8n-instance.com

# Optional enhancements
PERFORMANCE_MONITORING=true
REAL_TIME_MONITORING=true
CACHE_ENABLED=true
```

### Usage

```bash
# Start the enhanced server
npm start

# Development mode with auto-reload
npm run dev

# Run comprehensive tests
npm test
```

## Enhanced Tools

The server provides 32 tools including 7 enhanced tools:

- `get_execution_details_enhanced` - Comprehensive execution analysis
- `analyze_execution_errors_comprehensive` - Intelligent error analysis
- `create_workflow_from_template` - Template-based workflow creation
- `validate_workflow_comprehensive` - Multi-layer validation
- `monitor_credential_health` - Automated credential monitoring
- `identify_performance_bottlenecks` - Performance optimization
- `analyze_resource_usage` - Resource consumption analytics

## Performance

| Operation | Response Time | Throughput |
|-----------|---------------|------------|
| Enhanced Execution Details | < 500ms | 100 req/min |
| Error Analysis | < 1000ms | 50 req/min |
| Workflow Validation | < 2000ms | 30 req/min |
| Performance Analysis | < 3000ms | 20 req/min |

## AI Assistant Integration

Perfect for use with:
- Claude (Anthropic)
- ChatGPT (OpenAI)
- Other MCP-compatible AI assistants

## Requirements

- Node.js >= 18.0.0
- Valid n8n instance with API access
- n8n API key

## Documentation

For complete documentation, examples, and advanced configuration:
- [Enhanced README](https://github.com/zrald/enhanced-n8n-mcp-server/blob/main/README-ENHANCED.md)
- [Changelog](https://github.com/zrald/enhanced-n8n-mcp-server/blob/main/CHANGELOG.md)
- [API Documentation](https://github.com/zrald/enhanced-n8n-mcp-server/blob/main/docs/)

## License

MIT

## Support

- [GitHub Issues](https://github.com/zrald/enhanced-n8n-mcp-server/issues)
- [Documentation](https://github.com/zrald/enhanced-n8n-mcp-server)

---

**Transform your n8n workflows with AI-powered insights and professional-grade management! 🚀**