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 an MCP server for managing n8n workflows, offering functionality to list, create, update, delete, activate, and deactivate workflows through a set of defined tools. Also supports listing, retrieving, and deleting workflow executions.

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:

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.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Un servidor para crear y administrar mediante programación flujos de trabajo n8n con una interfaz API REST, que admite la creación, validación y exportación de flujos de trabajo.

Related Resources

Reddit Discussion about this server

n8n Workflow Builder MCP Server