remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides tools for programmatic creation and management of n8n workflows, allowing for listing, creating, updating, deleting, activating and deactivating workflows, as well as managing workflow executions.
Utilizes Zod for comprehensive schema validation of both input and output data in workflow management operations.
constructor mcp-n8n
Un servidor de Protocolo de Contexto de Modelo (MCP) para la creación y gestión programática de flujos de trabajo de n8n. Este servidor proporciona herramientas y recursos para interactuar con la API REST de n8n, lo que permite a los asistentes de IA crear, modificar y gestionar flujos de trabajo sin intervención directa del usuario.
Características
- 🔄 Gestión de flujos de trabajo : crear, leer, actualizar, eliminar, activar y desactivar flujos de trabajo
- 📊 Gestión de ejecución : Enumere y recupere detalles de ejecución del flujo de trabajo
- ✅ Validación de esquema : validación integral con Zod para datos de entrada y salida
- 🔍 Validación de nodos : valida los tipos de nodos contra los nodos disponibles de n8n antes de la creación del flujo de trabajo para evitar errores
- 🤔 Sugerencias inteligentes : proporciona sugerencias para tipos de nodos similares cuando se detectan nodos no válidos
- 🛠️ Manejo de errores : Mensajes de error detallados para la solución de problemas
- 📝 Documentación : Amplia documentación para todas las herramientas y recursos
- 🔍 Buscar y filtrar : filtre los flujos de trabajo por nombre, etiquetas o estado activo
Configuración
Este servidor requiere configuración a través de su cliente MCP. A continuación, se muestran ejemplos para diferentes entornos:
Configuración de Cline
Agregue esto a su configuración de Cline MCP:
Escritorio Claude con configuración WSL
Para entornos WSL, agregue esto a su configuración de Claude Desktop:
Variables de entorno
El servidor se puede configurar mediante variables de entorno:
| Variable | Descripción | Por defecto |
|---|---|---|
N8N_HOST | URL de la API n8n | http://localhost:5678/api/v1 |
N8N_API_KEY | Clave API para la autenticación n8n | "" |
SERVER_NAME | Nombre del servidor MCP | "n8n-workflow-builder" |
SERVER_VERSION | Versión del servidor MCP | Versión del paquete |
LOG_LEVEL | Nivel de registro | "info" |
CACHE_ENABLED | Habilitar el almacenamiento en caché | false |
CACHE_TTL | TTL de caché en segundos | 300 |
OUTPUT_VERBOSITY | Nivel de verbosidad de salida ( concise o full ) | "concise" |
Herramientas MCP
Gestión de nodos
list_available_nodes: Enumera todos los nodos disponibles en la instancia n8n. IMPORTANTE : Use esta herramienta ANTES de crear o actualizar flujos de trabajo para asegurarse de usar únicamente tipos de nodos válidos. Esto ayuda a prevenir errores causados por el uso de tipos de nodos que no existen en la instancia n8n actual.
Gestión del flujo de trabajo
list_workflows: Lista todos los flujos de trabajo de n8n con su información básica, como ID, nombre, estado, fecha de creación y etiquetas. Los resultados se pueden filtrar por estado activo, etiquetas o nombre.create_workflow: Crea un nuevo flujo de trabajo en n8n con los nodos y conexiones especificados. Devuelve el flujo de trabajo creado con su ID asignado. Valida que todos los tipos de nodo existan en la instancia n8n.get_workflow: recupera detalles completos de un flujo de trabajo específico por su ID, incluidos todos los nodos, conexiones, configuraciones y metadatos.update_workflow: Actualiza un flujo de trabajo existente con la nueva configuración. Se debe proporcionar la estructura completa del flujo de trabajo, no solo las partes que se modifican. Valida que todos los tipos de nodo existan en la instancia n8n.delete_workflow: Elimina permanentemente un flujo de trabajo por su ID. Esta acción no se puede deshacer.activate_workflow: activa un flujo de trabajo por su ID, lo que le permite ejecutarse automáticamente en función de su disparador.deactivate_workflow: desactiva un flujo de trabajo por su ID, evitando que se ejecute automáticamente.
Gestión de la ejecución
list_executions: Muestra el historial de ejecución del flujo de trabajo con detalles sobre el estado de éxito/error, la duración y las marcas de tiempo. Los resultados se pueden filtrar por ID de flujo de trabajo, estado y limitar a un número específico.get_execution: recupera información detallada sobre la ejecución de un flujo de trabajo específico, incluido el tiempo de ejecución, el estado y, opcionalmente, todos los datos procesados en cada paso.
Recursos de MCP
n8n://workflows: Lista de todos los flujos de trabajo en n8nn8n://workflows/{id}: Detalles de un flujo de trabajo n8n específicon8n://executions/{id}: Detalles de la ejecución de un flujo de trabajo n8n específico
Desarrollo
Configuración
- Clonar el repositorio
- Instalar dependencias:
- Construir el proyecto:
- Ejecutar en modo de desarrollo:
Publicación
El proyecto utiliza conjuntos de cambios para la gestión de versiones. Para publicar:
- Crear un conjunto de cambios:
- Versionar el paquete:
- Publicar en npm:
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.
Expresiones de gratitud
- Construido sobre el Protocolo de Contexto Modelo
- Desarrollado por n8n
You must be authenticated.
Tools
Servidor MCP para la creación y gestión programática de flujos de trabajo de n8n. Permite a los asistentes de IA crear, modificar y gestionar flujos de trabajo sin intervención directa del usuario mediante un completo conjunto de herramientas y recursos para interactuar con la API REST de n8n.