n8n MCP Server

by lowprofix

Integrations

  • Supports integration with n8n instances hosted on Cloudron, specifically mentioning connectivity to instances on n8n.bienquoi.com.

  • Offers ready-to-use workflow templates for Google Calendar integrations through n8n.

  • Provides tools for validating and managing n8n workflows, including workflow validation against best practices, workflow management (listing, retrieving, creating, updating, deleting, exporting, importing), and direct access to the n8n API for advanced operations.

Serveur MCP pour n8n

Ce projet est un serveur MCP (Master Control Program) pour n8n qui fournit des outils de validation de workflows et de bonnes pratiques pour vos projets d'automatisation n8n.

Fonctionnalités

  • Validation de workflows : Vérifiez que vos workflows respectent les bonnes pratiques
    • Conventions de nommage
    • Gestion des erreurs
    • Sécurité
    • Performance
    • Documentation
  • Intégration NextJS : Générez des intégrations pour vos workflows n8n dans des applications NextJS
    • Génération automatique de routes API
    • Création de documentation OpenAPI/Swagger
    • Génération de types TypeScript
    • Client API pour faciliter l'intégration
  • Gestion des workflows : Interagissez avec vos workflows n8n (liste, récupération, création, mise à jour, suppression, export, import)
  • API n8n : Accédez directement à l'API n8n pour des opérations avancées
  • Templates de workflows : Utilisez des templates prêts à l'emploi pour différents cas d'usage, notamment Google Calendar

Prérequis

  • Node.js (v16 ou supérieur)
  • pnpm (v7 ou supérieur)
  • Une instance n8n (locale ou distante comme votre instance Cloudron sur n8n.bienquoi.com)

Installation

  1. Clonez ce dépôt ou naviguez vers le dossier du projet
  2. Installez les dépendances :
pnpm install
  1. Configurez les variables d'environnement :
cp .env.example .env

Modifiez le fichier .env avec vos informations de connexion à l'API n8n.

Utilisation

Construction du projet

pnpm build

Démarrage du serveur

pnpm start

Le serveur MCP sera accessible à l'adresse http://localhost:3000 (ou le port spécifié dans votre fichier .env).

Utilisation avec Claude Desktop

Pour utiliser ce serveur MCP avec Claude Desktop, vous devez configurer le fichier claude_desktop_config.json dans le dossier %APPDATA%/Claude/ :

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

Structure du projet

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

Outils disponibles

1. N8nApiTool

Interagit directement avec l'API n8n.

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

2. WorkflowManagerTool

Gère les workflows n8n (liste, récupère, crée, met à jour, supprime, exporte, importe).

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

3. NextJSIntegrationTool

Génère des intégrations NextJS pour les workflows n8n.

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

4. WorkflowValidatorTool

Valide les workflows n8n selon différents critères.

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

Contribution

Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request.

Licence

MIT

-
security - not tested
F
license - not found
-
quality - not tested

A Master Control Program server that provides workflow validation tools and best practices for n8n automation projects, including workflow management, NextJS integration, and API access.

  1. Fonctionnalités
    1. Prérequis
      1. Installation
        1. Utilisation
          1. Construction du projet
          2. Démarrage du serveur
          3. Utilisation avec Claude Desktop
        2. Structure du projet
          1. Outils disponibles
            1. 1. N8nApiTool
            2. 2. WorkflowManagerTool
            3. 3. NextJSIntegrationTool
            4. 4. WorkflowValidatorTool
          2. Contribution
            1. Licence

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A server for programmatically creating and managing n8n workflows with a REST API interface, supporting workflow creation, validation, and export.
                Last updated -
                10
                28
                103
                JavaScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.
                Last updated -
                3,426
                77
                TypeScript
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                Used to create an assistant integrated with n8n that can search n8n documentation, example workflows, and community forums.
                Last updated -
                1
                6
                Python
                MIT License

              View all related MCP servers

              ID: zjn2iy97sr