n8n-workflow-builder-mcp

Generador de flujo de trabajo n8n MCP

Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) para crear y manipular flujos de trabajo n8n en formato JSON en Cursor IDE. Permite crear flujos de trabajo n8n simplemente mediante indicaciones con IA en el chat.

VÍDEO DEMOSTRACIÓN:

Estado actual de implementación

Está en una etapa temprana de desarrollo. Básicamente, funciona: el servidor MCP crea un archivo JSON con el flujo de trabajo n8n que se puede copiar y pegar en el editor de flujo de trabajo de la interfaz de usuario de n8n. Problemas actuales:

• A veces, los agentes de LLM introducen parámetros incorrectos en la solicitud. Planeo encontrar una solución .
• A veces, la conexión entre nodos no se configura. Estoy trabajando para solucionarlo .
• No todos los tipos de nodos funcionan correctamente. Estoy trabajando para solucionarlo .
• El mensaje inicial sí importa. Si no es claro, el agente se equivocará. Planeo encontrar una solución .

Características principales

• Gestión del flujo de trabajo : crear, actualizar y ejecutar flujos de trabajo n8n mediante programación (la ejecución aún no está implementada)
• Descubrimiento de nodos : explore los nodos n8n disponibles y sus capacidades
• Gestión de conexiones : crear conexiones entre nodos de flujo de trabajo
• Integración de IA : herramientas especiales para conectar componentes de IA en flujos de trabajo
• Interfaz compatible con IA : diseñada específicamente para la interacción con agentes de IA

Prerrequisitos

• Node.js (v14 o superior)
• Cursor IDE (v0.48 o más reciente)
• npm o hilo
• Compilador de TypeScript (instalado como una dependencia de desarrollo a través de npm install )

Instalación

1. Clonar el repositorio:
   git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git cd n8n-workflow-builder-mcp
2. Instalar dependencias:
   npm install
3. Construya el proyecto TypeScript:
   npm run build
4. Haga que el script del servidor MCP sea ejecutable (si es necesario):
   chmod +x dist/index.js

Ejecución del servidor

Inicie el servidor MCP:

Esto ejecutará el código compilado de dist/index.js .

Para desarrollo con reconstrucción automática y reinicio ante cambios:

Integración de Cursor IDE

Hay dos formas de configurar el servidor MCP con Cursor:

Método 1: Usar la interfaz de configuración del cursor (recomendado)

1. Cursor de inicio IDE
2. Vaya a Configuración > Características > Servidores MCP
3. Haga clic en "Agregar servidor" y proporcione la ruta absoluta al archivo dist/index.js (por ejemplo, /Users/yourname/n8n-workflow-builder-mcp/dist/index.js )
4. Asegúrese de que el servidor esté habilitado
5. Reinicie Cursor IDE para que los cambios surtan efecto

Método 2: Configuración manual

1. Asegúrese de que el directorio .cursor exista:
   mkdir -p .cursor
2. Cree el archivo de configuración MCP:
   cat > .cursor/mcp.json << 'EOF' { "mcpServers": { "n8n-workflow-builder": { "command": "node", "args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"] } } } EOF
   Asegúrese de reemplazar /absolute/path/to con la ruta real en su sistema.
3. Reinicie Cursor IDE para que los cambios surtan efecto

Herramientas MCP disponibles

El servidor proporciona las siguientes herramientas para trabajar con flujos de trabajo n8n:

Solución de problemas de integración del cursor

Si tiene problemas para que el servidor MCP funcione con Cursor, pruebe estos pasos:

1. Reiniciar Cursor : después de configurar el MCP, cierre completamente y reinicie Cursor.
2. Compruebe la configuración del MCP del cursor :
   • Abrir configuración del cursor
   • Vaya a Características > Servidores MCP
   • Asegúrese de que su servidor esté listado y habilitado
   • Si aparece en la lista pero no funciona, intenta hacer clic en el botón Actualizar
3. Revisar los registros del servidor : Busque errores en la terminal donde ejecuta el servidor o en el panel de Salida del Cursor. Seleccione "Cursor MCP" en el menú desplegable del panel de Salida para ver los registros específicos del MCP.
4. Verificar los permisos del archivo : asegúrese de que el archivo dist/index.js tenga permisos de ejecución.
5. Comprobar si hay conflictos de puertos : Si hay otros servidores MCP en ejecución, podrían entrar en conflicto. Compruebe si hay otros procesos que utilicen los mismos puertos.
6. Pruebe la instalación global : en lugar de utilizar una ruta local, puede intentar instalar el servidor globalmente:
   npm install -g n8n-workflow-builder-mcp
   Luego actualice el archivo .cursor/mcp.json para usar el comando global.

Problemas comunes y soluciones

"Error al crear el cliente"

Esto suele ocurrir cuando:

• El servidor MCP no se está ejecutando
• Hay un problema de conectividad entre Cursor y el servidor.
• El servidor se bloqueó durante la inicialización.

Intentar:

1. Ejecutar el script de prueba para asegurarse de que el servidor funciona correctamente
2. Comprobación de errores en los registros del servidor
3. Reiniciando el cursor

El servidor MCP no aparece en el cursor

Esto puede suceder si:

• El archivo .cursor/mcp.json no tiene el formato correcto
• El cursor no ha detectado el cambio de configuración

Intentar:

1. Validar el formato JSON de su archivo .cursor/mcp.json
2. Reiniciando el cursor
3. Seleccionar manualmente el servidor en la configuración del cursor (si aparece allí)

El servidor MCP aparece pero las herramientas no están disponibles

Esto puede suceder si:

• El servidor no está registrando correctamente sus herramientas
• Hay un problema con la solicitud/respuesta de ListOfferings

Intentar:

1. Ejecutar el script de prueba para verificar si las herramientas están registradas correctamente
2. Al hacer clic en el botón Actualizar en la configuración del servidor MCP en Cursor
3. Comprobación de los registros del servidor para detectar posibles errores

Estructura del proyecto

• /src : Código fuente principal
• /src/tools : Implementación de herramientas MCP
• /src/models : Modelos de datos
• /src/utils : Funciones de utilidad
• /src/middleware : Autenticación y middleware
• /config : Archivos de configuración
• /tests : Archivos de prueba
• /workflow_nodes : n8n definiciones de nodos
• /docs : Documentación adicional

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio
2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
4. Empujar a la rama ( git push origin feature/amazing-feature )
5. Abrir una solicitud de extracción

Licencia

Trabajando con licencia: se necesita confirmación del equipo n8n