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

Related MCP server: n8n Workflow Generator MCP Server

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:

{
	"mcpServers": {
		"n8n-workflow-builder": {
			"command": "npx",
			"args": ["-y", "mcp-n8n-builder"],
			"env": {
				"N8N_HOST": "http://localhost:5678/api/v1",
				"N8N_API_KEY": "your-n8n-api-key",
				"OUTPUT_VERBOSITY": "concise" // Options: 'concise' or 'full'
			}
		}
	}
}

Escritorio Claude con configuración WSL

Para entornos WSL, agregue esto a su configuración de Claude Desktop:

{
	"mcpServers": {
		"n8n-workflow-builder": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"N8N_HOST=http://localhost:5678/api/v1 N8N_API_KEY=your-n8n-api-key OUTPUT_VERBOSITY=concise npx -y mcp-n8n-builder"
			]
		}
	}
}

Variables de entorno

El servidor se puede configurar mediante variables de entorno:

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 n8n

• n8n://workflows/{id} : Detalles de un flujo de trabajo n8n específico

• n8n://executions/{id} : Detalles de la ejecución de un flujo de trabajo n8n específico

Desarrollo

Configuración

1. Clonar el repositorio

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

4. Ejecutar en modo de desarrollo:

npm run dev

Publicación

El proyecto utiliza conjuntos de cambios para la gestión de versiones. Para publicar:

1. Crear un conjunto de cambios:

npm changeset

2. Versionar el paquete:

npm changeset version

3. Publicar en npm:

npm release

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