n8n-mcp-project by ortiq01 - MCP Server

n8n-MCP Integration Project

A comprehensive Model Context Protocol (MCP) server implementation for n8n automation platform with enterprise-grade backup protection and workflow management capabilities.

🚀 Features

Core MCP Server

Minimal MCP Server: Lightweight, efficient MCP implementation
n8n Integration: Seamless integration with n8n workflows
4 Essential Tools: File operations, workflow validation, data generation, and performance testing
100% Test Coverage: Comprehensive testing suite with verified functionality

Backup & Protection System

Automated Backups: 14-category comprehensive backup system
One-Click Restore: Complete system restoration capabilities
Daily Automation: Automated backup scheduling
Security Hardened: Environment variable protection and input sanitization

Development Framework

Docker Integration: Production-ready containerized environment
Version Control: Git-based development workflow with GitHub integration
Documentation: Comprehensive guides and status monitoring
System Monitoring: Real-time health checks and performance metrics

📁 Project Structure

├── minimal-mcp/           # Core MCP server implementation
│   ├── server.js         # Main MCP server
│   ├── test.js           # Comprehensive test suite
│   └── package.json      # Dependencies and scripts
├── docker/               # Docker configuration
│   ├── docker-compose.yml
│   └── n8n_data/        # n8n persistent data
├── backups/              # Automated backup storage
├── backup-system.sh      # Backup creation script
├── restore-system.sh     # System restoration script
└── setup-automated-backups.sh  # Backup automation setup

🛠 Quick Start

Prerequisites

Docker & Docker Compose
Node.js 18+ (for MCP server)
Git (for version control)

Installation

Clone the repository:

git clone https://github.com/ortiq01/n8n-mcp-project.git
cd n8n-mcp-project

Start the services:
```
docker-compose up -d
```
Test the MCP server:
```
cd minimal-mcp && npm test
```
Access n8n: Open http://localhost:5679

Setting Up Backups

# Create initial backup
./backup-system.sh

# Set up automated daily backups
./setup-automated-backups.sh

# Restore from backup if needed
./restore-system.sh

🔧 MCP Tools Available

Tool	Description	Usage
write_file	Create/update files	Workflow automation, data persistence
validate_workflow	Workflow validation	Quality assurance, error prevention
generate_test_data	Test data generation	Development, testing scenarios
performance_test	Performance monitoring	System optimization, benchmarking

📊 System Status

✅ n8n Server: Running on port 5679
✅ PostgreSQL: Database operational
✅ MCP Server: 100% test pass rate
✅ Backup System: 25MB initial backup created
✅ Version Control: GitHub integration active

🔒 Security Features

SSH Key Protection: All private keys excluded from repository
Environment Variables: Secure credential management
Input Sanitization: XSS and injection prevention
Backup Encryption: Compressed, secure backup archives
Access Controls: Production-ready security configuration

📖 Documentation

- Backup system overview
- Current system health
- Production deployment guide

🧪 Testing

Run the comprehensive test suite:

cd minimal-mcp
npm test

Expected output: ✅ 5/5 tests passing

🤝 Contributing

Fork the repository
Create a feature branch: git checkout -b feature-name
Make your changes and test thoroughly
Commit with descriptive messages: git commit -m "feat: description"
Push to your fork: git push origin feature-name
Create a Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🆘 Support

Issues: Report bugs and feature requests via GitHub Issues
Documentation: Check the /docs directory for detailed guides
Community: Join our discussions for help and collaboration

Built with ❤️ for workflow automation and MCP integration