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

Related MCP server: n8n MCP Server

Guía de instalación extensa

1. Clonar el repositorio

Clona el repositorio desde tu fuente preferida. Por ejemplo:

git clone https://github.com/makafeli/n8n-workflow-builder.git

Luego, navegue hasta el directorio del proyecto:

cd /root/n8n-workflow-builder

2. Instalar dependencias

Instale las dependencias necesarias usando npm:

npm install

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 :

{
  "n8n-workflow-builder": {
    "command": "node",
    "args": ["/root/n8n-workflow-builder/build/index.js"],
    "env": {
      "N8N_HOST": "https://n8n.io/api/v1/",
      "N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
    },
    "disabled": false,
    "alwaysAllow": [
      "create_workflow",
      "create_workflow_and_activate",
      "update_workflow",
      "activate_workflow",
      "deactivate_workflow",
      "get_workflow",
      "delete_workflow"
    ],
    "autoApprove": []
  }
}

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.