Servidor MCP para n8n

Este proyecto es un servidor de programa de control maestro (MCP) para n8n que proporciona herramientas de validación de flujo de trabajo y mejores prácticas para sus proyectos de automatización de n8n.

Características

• Validación del flujo de trabajo : compruebe que sus flujos de trabajo siguen las mejores prácticas

  • Convenciones de nomenclatura

  • Manejo de errores

  • Seguridad

  • Actuación

  • Documentación

• Integración con NextJS : genere integraciones para sus flujos de trabajo n8n en aplicaciones NextJS

  • Generación automática de rutas API

  • Creación de documentación de OpenAPI/Swagger

  • Generación de tipos de TypeScript

  • Cliente API para facilitar la integración

• Gestión del flujo de trabajo : interactúa con tus flujos de trabajo n8n (enumera, recupera, crea, actualiza, elimina, exporta, importa)

• API n8n : acceda directamente a la API n8n para operaciones avanzadas

• Plantillas de flujo de trabajo : utilice plantillas listas para usar para diferentes casos de uso, incluido Google Calendar

Related MCP server: mcp-n8n-builder

Prerrequisitos

• Node.js (v16 o superior)

• pnpm (v7 o superior)

• Una instancia n8n (local o remota como su instancia de Cloudron en n8n.bienquoi.com)

Instalación

1. Clona este repositorio o navega a la carpeta del proyecto

2. Instalar las dependencias:

pnpm install

3. Configurar las variables de entorno:

cp .env.example .env

Edite el archivo .env con la información de conexión de la API n8n.

Usar

Construcción del proyecto

pnpm build

Inicio del servidor

pnpm start

Se podrá acceder al servidor MCP en http://localhost:3000 (o el puerto especificado en su archivo .env).

Usar con Claude Desktop

Para utilizar este servidor MCP con Claude Desktop, debe configurar el archivo claude_desktop_config.json en la carpeta %APPDATA%/Claude/ :

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "node",
      "args": ["/chemin/absolu/vers/mcp-n8n-server/dist/server.js"]
    }
  }
}

Estructura del proyecto

mcp-n8n-server/
├── src/                    # Code source
│   ├── tools/              # Outils MCP
│   │   ├── N8nApiTool.ts                # Outil pour interagir avec l'API n8n
│   │   ├── WorkflowManagerTool.ts       # Outil pour gérer les workflows
│   │   ├── NextJSIntegrationTool.ts     # Outil pour générer des intégrations NextJS
│   │   ├── WorkflowValidatorTool.ts     # Outil pour valider les workflows
│   │   └── ...
│   ├── validators/         # Validateurs de workflows
│   │   ├── naming.js       # Validateur de conventions de nommage
│   │   ├── errorHandling.js # Validateur de gestion des erreurs
│   │   ├── security.js     # Validateur de sécurité
│   │   ├── performance.js  # Validateur de performance
│   │   └── documentation.js # Validateur de documentation
│   ├── resources/          # Ressources partagées
│   └── server.ts           # Point d'entrée du serveur
├── dist/                   # Code compilé
├── public/                 # Fichiers statiques
├── output/                 # Répertoire pour les sorties des outils
├── .env.example            # Exemple de fichier de configuration
└── README.md               # Documentation

Herramientas disponibles

1. Herramienta N8nApi

Interactúa directamente con la API n8n.

// Exemple d'utilisation
{
  "method": "GET",
  "endpoint": "/workflows",
  "params": "?active=true"
}

2. Herramienta de gestión de flujo de trabajo

Administra flujos de trabajo n8n (enumerar, recuperar, crear, actualizar, eliminar, exportar, importar).

// Exemple d'utilisation
{
  "action": "list",
  "tags": "production"
}

3. Herramienta de integración NextJS

Genera integraciones de NextJS para flujos de trabajo n8n.

// Exemple d'utilisation
{
  "workflowId": "123",
  "outputDir": "./my-nextjs-app/pages/api",
  "generateTypes": true,
  "generateOpenAPI": true
}

4. Herramienta de validación de flujo de trabajo

Valida flujos de trabajo n8n según varios criterios.

// Exemple d'utilisation
{
  "workflow": "{...}",
  "validators": ["naming", "errorHandling", "security"],
  "strictness": "high"
}

Contribución

¡Las contribuciones son bienvenidas! No dudes en abrir un problema o una solicitud de extracción.

Licencia

Instituto Tecnológico de Massachusetts (MIT)