🚀 n8n + Flowise + MCP + PostgreSQL - Stack de Automatización

Stack completo de automatización con n8n, Flowise, MCP Server y PostgreSQL, configurado con las mejores prácticas Docker 2025.

📋 Características

✅ Implementado

• n8n 1.99.1 con soporte MCP y plugins avanzados
• Flowise 3.0.3 con PostgreSQL y custom nodes
• MCP Server v0.7.0 para integración IA
• PostgreSQL 15-alpine para ambas aplicaciones
• Healthchecks para todos los servicios
• Variables de entorno centralizadas y seguras
• Scripts de gestión automatizados
• Documentación completa y profesional
• Plugins y extras NO nativos (más de 80 plugins para n8n)
• Custom nodes para Flowise
• Herramientas MCP personalizables
• Sistema de backup automático
• Scripts de instalación y actualización

🔥 Plugins y Extras Incluidos

n8n (80+ plugins NO nativos)

• IA y Machine Learning: LangChain, OpenAI, Anthropic, Cohere, HuggingFace, Ollama, LocalAI
• Automatización Avanzada: Scheduler, Cron, Webhook Manager, Workflow Trigger
• Integración de Datos: Supabase, Airtable, Notion, ClickHouse, InfluxDB, TimescaleDB
• Monitoreo: Prometheus, Grafana, Datadog, New Relic, Sentry
• Comunicación: Slack, Discord, Telegram, WhatsApp, Teams, Google Chat
• Almacenamiento: AWS S3, Google Cloud, Azure, Dropbox, Box, OneDrive
• DevOps: GitHub, GitLab, Docker, Kubernetes, Vercel, Netlify, Heroku
• E-commerce: Shopify, WooCommerce, Stripe, PayPal, MercadoPago
• Marketing: HubSpot, Salesforce, Pipedrive, Mailchimp, SendGrid, Twilio
• Productividad: Asana, Trello, Monday, Jira, Linear, ClickUp
• Análisis: Google Analytics, Mixpanel, Amplitude, Hotjar, FullStory
• Seguridad: Auth0, Okta, Keycloak, LDAP, OAuth2
• Utilidades: JSON Transform, XML Parser, CSV Processor, Excel, PDF, Image/Video Processor, OCR
• Blockchain: Ethereum, Polygon, BSC, IPFS, NFTs
• IoT: MQTT, Arduino, Raspberry Pi, Zigbee, Z-Wave

Flowise (Custom Nodes)

• Estructura preparada para custom nodes
• Integraciones nativas con todos los modelos de IA principales
• Bases de datos vectoriales nativas (Pinecone, Weaviate, Qdrant, Milvus, Chroma)

MCP (Herramientas Personalizables)

• Estructura preparada para herramientas personalizadas
• Configuración automática de herramientas
• Integración con modelos de IA estandarizada

🚀 Instalación Rápida

1. Clonar y configurar

git clone <repository-url>
cd n8n-flowise-automation-stack
cd config
cp env.example .env
# Editar .env con tus configuraciones

2. Instalar plugins y extras

# Instalar todos los plugins automáticamente
./install-plugins.sh

# O instalar manualmente
cd n8n-custom
npm install
cd ..
docker compose restart n8n

3. Iniciar servicios

docker compose up -d

📚 Documentación

📖 Documentación Principal

• 📋 README Principal - Este archivo
• 🐳 Configuración Docker - Guía de configuración
• 🚀 Plugins y Extras - Documentación completa de plugins

🤖 Servicios Específicos

• n8n - Documentación específica de n8n
• Flowise - Documentación específica de Flowise
• MCP Server - Documentación del servidor MCP
• PostgreSQL - Documentación de bases de datos

🛠️ Gestión y Mantenimiento

Scripts de Gestión

# Gestión general
./manage.sh [comando]

# Instalación de plugins
./install-plugins.sh

# Actualización de plugins (con backup automático)
./update-plugins.sh

# Verificación de portabilidad
./check-portability.sh

Comandos Útiles

# Ver estado de servicios
docker compose ps

# Ver logs
docker compose logs -f

# Ver plugins instalados
docker compose exec n8n npm list --depth=0

# Backup manual
./manage.sh backup

# Actualizar imágenes
./manage.sh update

🌐 Acceso a Servicios

Servicio	URL	Credenciales
n8n	http://localhost:5678	admin / admin123
Flowise	http://localhost:3001	admin / admin123
MCP Server	http://localhost:3000	Interno
PostgreSQL n8n	localhost:5432	n8n / n8n_password
PostgreSQL Flowise	localhost:5433	flowiseuser / [configurado]

🔧 Configuración Avanzada

Variables de Entorno Importantes

# n8n
N8N_ENCRYPTION_KEY=your-encryption-key-here
N8N_MCP_SERVER_TOKEN=your-mcp-token-here

# Flowise
JWT_AUTH_TOKEN_SECRET=your-jwt-auth-secret
JWT_REFRESH_TOKEN_SECRET=your-jwt-refresh-secret

# PostgreSQL
POSTGRES_PASSWORD=n8n_password
FLOWISE_DB_PASSWORD=your-flowise-db-password

Generar Claves Seguras

# Clave de encriptación para n8n
openssl rand -hex 32

# Token para MCP
openssl rand -hex 16

# Claves JWT
openssl rand -hex 32

🔄 Actualizaciones

Actualizar Plugins

# Actualización automática con backup
./update-plugins.sh

# Actualización manual
cd n8n-custom
npm update
cd ..
docker compose restart n8n

Actualizar Servicios

# Actualizar imágenes Docker
./manage.sh update

# Reiniciar servicios
./manage.sh restart

🛡️ Seguridad

Mejores Prácticas Implementadas

• ✅ Usuarios no root donde es posible
• ✅ Variables de entorno seguras
• ✅ Healthchecks para todos los servicios
• ✅ Backup automático antes de actualizaciones
• ✅ Verificación de vulnerabilidades en plugins
• ✅ Documentación de secretos y claves

Configuración de Producción

1. Cambiar todas las contraseñas por defecto
2. Configurar SSL/TLS para acceso externo
3. Configurar firewall y acceso restringido
4. Monitorear logs regularmente
5. Hacer backups programados

🐛 Troubleshooting

Problemas Comunes

Plugin no aparece en n8n

# Verificar instalación
docker compose exec n8n npm list | grep plugin-name

# Verificar logs
docker compose logs n8n | grep -i error

# Reiniciar n8n
docker compose restart n8n

Custom node no aparece en Flowise

# Verificar estructura
ls -la config/flowise-custom/nodes/

# Verificar package.json
cat config/flowise-custom/nodes/MyNode/package.json

# Ver logs de Flowise
docker compose logs flowise | grep -i custom

Herramienta MCP no funciona

# Verificar configuración
cat config/mcp-config/config.json

# Verificar logs de MCP
docker compose logs mcp-server

# Probar conectividad
curl http://localhost:3000/health

Logs de Debug

# n8n debug
docker compose exec n8n n8n start --debug

# Flowise debug
docker compose exec flowise flowise start --debug

# MCP debug
docker compose logs mcp-server --tail=100

📊 Monitoreo

Healthchecks

Todos los servicios incluyen healthchecks automáticos:

• n8n: /healthz endpoint
• Flowise: /api/v1/ping endpoint
• PostgreSQL: pg_isready command
• MCP Server: /health endpoint

Métricas

# Ver estado de contenedores
docker compose ps

# Ver uso de recursos
docker stats

# Ver logs en tiempo real
docker compose logs -f

🔗 Integración

n8n + MCP

• Configuración automática de MCP en n8n
• Nodos MCP disponibles en workflows
• Integración con modelos de IA estandarizada

Flowise + PostgreSQL

• Base de datos vectorial para embeddings
• Persistencia de datos y configuraciones
• Backup automático de datos

n8n + Flowise

• Comunicación a través de webhooks
• Integración de workflows entre plataformas
• Compartir datos y resultados

📈 Escalabilidad

Recursos Recomendados

• Mínimo: 4GB RAM, 2 CPU cores, 20GB disco
• Recomendado: 8GB RAM, 4 CPU cores, 50GB disco
• Producción: 16GB RAM, 8 CPU cores, 100GB disco

Configuración de Recursos

# En docker-compose.yml
services:
  n8n:
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '1.0'
        reservations:
          memory: 1G
          cpus: '0.5'

🤝 Contribución

Estructura del Proyecto

n8n-flowise-automation-stack/
├── config/                 # Configuración Docker
│   ├── docker-compose.yml  # Stack principal
│   ├── n8n-custom/         # Plugins n8n
│   ├── flowise-custom/     # Custom nodes Flowise
│   └── mcp-config/         # Herramientas MCP
├── docs/                   # Documentación
├── scripts/                # Scripts de gestión
└── backups/                # Backups automáticos

Agregar Nuevos Plugins

1. Editar config/n8n-custom/package.json
2. Ejecutar ./install-plugins.sh
3. Documentar en docs/PLUGINS-AND-EXTRAS.md
4. Probar funcionalidad

📞 Soporte

Enlaces Útiles

• Documentación oficial de n8n
• Documentación oficial de Flowise
• Model Context Protocol
• Docker Compose Documentation

Comunidades

• n8n Community
• Flowise Discord
• MCP GitHub

📄 Licencia

Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.

---

🎯 Checklist de Instalación

• Stack básico configurado y funcionando
• Plugins n8n instalados (80+ plugins)
• Custom nodes Flowise preparados
• Herramientas MCP configuradas
• Scripts de gestión creados
• Documentación completa generada
• Sistema de backup implementado
• Healthchecks configurados
• Variables de entorno seguras
• Mejores prácticas 2025 implementadas

---

Última actualización: Enero 2025
Versiones: n8n 1.99.1, Flowise 3.0.3, MCP v0.7.0, PostgreSQL 15-alpine