n8n Manager for AI Agents

Gestiona instancias de automatización de flujos de trabajo de n8n mediante lenguaje natural usando la API pública de n8n.

GitHub

Prueba este MCPPatrocinado

Documentación

n8n Manager para Agentes de IA

[!IMPORTANT] Este repositorio ya no se encuentra en desarrollo activo. Las herramientas de gestión de instancias de n8n se han integrado en el proyecto más completo n8n-mcp, que proporciona una solución completa para la automatización de n8n con agentes de IA.

Por favor, utilice n8n-mcp para las últimas funciones y actualizaciones.

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude Desktop y otros agentes de IA gestionar instancias de automatización de flujos de trabajo de n8n a través de la API de n8n.

🎯 Resumen del Proyecto

Este servidor MCP proporciona a los agentes de IA herramientas para gestionar flujos de trabajo de n8n de forma programática. Implementa las operaciones principales de la API de n8n con soluciones inteligentes para las limitaciones de la API.

✅ Lo que Funciona

Gestión de Flujos de Trabajo: Crear, leer, actualizar y eliminar flujos de trabajo
Monitoreo de Ejecuciones: Listar y ver detalles de ejecuciones, eliminar registros de ejecución
Disparadores de Webhook: Ejecutar flujos de trabajo a través de endpoints de webhook
Monitoreo de Salud: Verificar la conectividad y configuración de la instancia de n8n

🚧 Limitaciones Actuales

Activación de Flujos de Trabajo: No se pueden activar/desactivar flujos de trabajo a través de la API (se requiere activación manual en la interfaz de usuario)
Ejecución Directa: No disponible - se deben utilizar disparadores de webhook
Etiquetas y Credenciales: Campos de solo lectura, no se pueden configurar a través de la API

🚀 Funciones Implementadas

Operaciones de Flujos de Trabajo: Operaciones CRUD completas para flujos de trabajo de n8n
Gestión de Ejecuciones: Ver, listar y eliminar registros de ejecución
Ejecución Basada en Webhooks: Disparar flujos de trabajo a través de URLs de webhook
Manejo Inteligente de Errores: Eliminación automática de campos de solo lectura, métodos alternativos
Descripciones Amigables para IA: Descripciones mejoradas de herramientas con ejemplos y limitaciones claras
Paginación Basada en Cursor: Manejo eficiente de grandes conjuntos de resultados
Monitoreo de Salud: Verificaciones integradas de conectividad y configuración

⚠️ Limitaciones de la API y Soluciones

Limitaciones Descubiertas

Activación de Flujos de Trabajo: El campo active es de solo lectura - los flujos de trabajo deben activarse manualmente en la interfaz de usuario
Campo de Etiquetas: Solo lectura durante la creación y actualización
Método PATCH: Algunas instancias de n8n no admiten PATCH para actualizaciones de flujos de trabajo
Ejecución Directa: Se deben utilizar disparadores de webhook (no hay API de ejecución directa)
Campo de Configuración: Requerido pero no documentado - proporcionamos valores predeterminados sensatos

No Implementado (API No Disponible)

Gestión de Usuarios: No hay endpoints de API públicos
Gestión de Credenciales: API limitada, esquemas no expuestos
Detener Ejecución: No se pueden detener ejecuciones en curso a través de la API
Variables: Solo disponibles a través de la API de control de código fuente
Importar/Exportar: Planificado pero aún no implementado

📦 Herramientas MCP Disponibles

Gestión de Flujos de Trabajo

n8n_create_workflow - Crear nuevos flujos de trabajo con nodos y conexiones
n8n_get_workflow - Recuperar detalles de flujos de trabajo por ID
n8n_update_workflow - Actualizar flujos de trabajo existentes (requiere lista completa de nodos)
n8n_delete_workflow - Eliminar flujos de trabajo permanentemente
n8n_list_workflows - Listar flujos de trabajo con filtrado y paginación

Gestión de Ejecuciones

n8n_trigger_webhook_workflow - Disparar flujos de trabajo a través de URL de webhook
n8n_get_execution - Obtener información detallada de ejecución
n8n_list_executions - Listar ejecuciones con filtrado por estado
n8n_delete_execution - Eliminar registros de ejecución

Herramientas del Sistema

n8n_health_check - Verificar conectividad y configuración de la API

🛠️ Stack Tecnológico

Runtime: Node.js 20+
Lenguaje: TypeScript 5.0
SDK MCP: @modelcontextprotocol/sdk v1.13.1
Cliente HTTP: Axios con lógica de reintentos
Validación: Esquemas Zod
Registro: Winston (basado en archivos en modo MCP)
Compilación: TypeScript con módulos ES

📋 Requisitos Previos

Node.js 20 o superior
Instancia de n8n con acceso a la API habilitado
Clave de API de n8n
Claude Desktop (para integración MCP)

🚀 Inicio Rápido

Clonar el repositorio

git clone https://github.com/czlonkowski/n8n-manager-for-ai-agents
cd n8n-manager-for-ai-agents

Instalar dependencias
```
npm install
```

Configurar el entorno

cp .env.example .env
# Edit .env with your n8n instance details

Compilar el proyecto
```
npm run build
```

Configurar Claude Desktop Agregue a su configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "n8n-manager": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-manager-for-ai-agents/build/index.js"],
      "env": {
        "N8N_API_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production",
        "MCP_MODE": "stdio"
      }
    }
  }
}

Reinicie Claude Desktop y verifique que n8n-manager aparezca en la lista de herramientas MCP

📁 Archivos de Registro

Los registros se escriben en ~/.n8n-manager/logs/n8n-manager.log para evitar interferir con la comunicación del protocolo MCP.

💡 Ejemplos de Uso

Crear un Flujo de Trabajo Simple

"Create a workflow named 'Test API' with a manual trigger"

Listar Flujos de Trabajo

"Show me all active workflows"
"List workflows with tag 'production'"

Verificar Ejecuciones

"Show recent executions for workflow ID abc123"
"Get details of execution xyz789"

Ejecución de Webhook

"Trigger the webhook at https://n8n.example.com/webhook/abc-def-ghi"

📖 Documentación

CLAUDE.md - Guía de IA, ejemplos y soluciones de errores
Documento de Requisitos del Producto - Especificaciones originales del proyecto
Lista de Verificación de Implementación - Progreso del desarrollo

🧪 Desarrollo

# Run tests
npm test

# Run in development mode
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint

# Build for production
npm run build

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de Extracción (Pull Request). Para cambios importantes, abra un problema primero para discutir lo que le gustaría cambiar.

🔐 Seguridad

Las claves de API se almacenan en variables de entorno
No se registran datos sensibles
Todas las comunicaciones utilizan HTTPS
Implementa limitación de velocidad y validación de solicitudes

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.

🙏 Agradecimientos

n8n - La plataforma de automatización de flujos de trabajo
Anthropic - Por Claude y el protocolo MCP
Protocolo de Contexto de Modelo - El protocolo que permite esta integración

📞 Contacto

Romuald Czlonkowski
aiadvisors.pl

Fase 1 Completa: Las herramientas principales de gestión de flujos de trabajo y ejecuciones son totalmente funcionales. Consulte CLAUDE.md para obtener una guía de uso detallada y soluciones comunes de errores.