n8n Workflow Builder MCP Server

Servidor MCP del generador de flujos de trabajo n8n

Este proyecto proporciona un servidor MCP para gestionar flujos de trabajo n8n. Ofrece funcionalidades para listar, crear, actualizar, eliminar, activar y desactivar flujos de trabajo mediante un conjunto de herramientas definidas.

Importante:
Esta versión admite exclusivamente npm para la gestión de paquetes y la ejecución del servidor. (La compatibilidad con npx se reintroducirá en una futura actualización).

Requisitos

• Node.js (se recomienda v14+)
• npm

Guía de instalación extensa

1. Clonar el repositorio

Clona el repositorio desde tu fuente preferida. Por ejemplo:

Luego, navegue hasta el directorio del proyecto:

2. Instalar dependencias

Instale las dependencias necesarias usando npm:

Este comando descargará e instalará todos los paquetes necesarios según lo definido en el archivo package.json .

3. Construir y probar

Para probar y poner el servidor en línea, utilice los siguientes comandos:

• Construir el proyecto:
  Esto compila los archivos TypeScript y produce el JavaScript ejecutable en el directorio build .
  npm run build
• Inicie el servidor MCP:
  Inicie el servidor usando:
  npm start

El servidor se iniciará y se conectará mediante stdio. Puede consultar la consola para ver los mensajes que confirman que el servidor se ha iniciado correctamente.

4. Implementación

Para realizar pruebas y poner el servidor en línea, utilice los comandos de compilación e inicio mencionados anteriormente. Este flujo de trabajo básico (instalar, compilar, iniciar) es el método recomendado actualmente.

5. Configuración adicional

La configuración del servidor se gestiona mediante el archivo cline_mcp_settings.json . Asegúrese de que las siguientes variables de entorno estén configuradas correctamente:

• N8N_HOST : la URL de su host de API n8n.
• N8N_API_KEY : Su clave API n8n.

Ejemplo de configuración en cline_mcp_settings.json :

Funciones disponibles

Herramientas MCP

Las siguientes herramientas están definidas en el servidor y se puede acceder a ellas a través de su cliente MCP:

Gestión del flujo de trabajo

• list_workflows : enumera todos los flujos de trabajo de n8n.
• create_workflow : crea un nuevo flujo de trabajo en n8n.
• get_workflow : recupera un flujo de trabajo por su ID.
• update_workflow : actualiza un flujo de trabajo existente.
• delete_workflow : elimina un flujo de trabajo por su ID.
• activate_workflow : Activa un flujo de trabajo por su ID.
• deactivate_workflow : desactiva un flujo de trabajo por su ID.

Gestión de la ejecución

• list_executions : enumera todas las ejecuciones del flujo de trabajo con filtros opcionales.
• get_execution : recupera detalles de una ejecución específica por su ID.
• delete_execution : elimina una ejecución por su ID.

Recursos de MCP

El servidor también proporciona los siguientes recursos para un acceso al contexto más eficiente:

Recursos estáticos

• /workflows : Lista de todos los flujos de trabajo disponibles en la instancia n8n
• /execution-stats : Estadísticas resumidas sobre las ejecuciones del flujo de trabajo

Plantillas de recursos dinámicos

• /workflows/{id} : Información detallada sobre un flujo de trabajo específico
• /ejecuciones/{id} : Información detallada sobre una ejecución específica

Solución de problemas

• Asegúrese de estar utilizando npm (esta versión no admite npx).
• Si encuentra algún problema, intente limpiar el directorio de compilación y volver a compilarlo:
  npm run clean && npm run build
• Verifique que sus variables de entorno en cline_mcp_settings.json sean correctas.

Mejoras futuras

• Reintroducción del soporte npx.
• Herramientas adicionales y funciones de flujo de trabajo.
• Más mejoras en la implementación y escalabilidad.

Licencia

Este proyecto está licenciado bajo la licencia MIT.