n8n Workflow Validator

by lowprofix

2 stars

Not rated

GitHub

About

Provides a validation and best practices framework for n8n workflows, enabling workflow validation, API integration, and workflow management through specialized validators for calendar integrations, documentation, error handling, naming conventions, performance, and security.

Details

Author: lowprofix
Repository: lowprofix/n8n-mcp-server
GitHub stars: 2
Categories: Productivity, Other, Automation, Developer Tools, Design, Workplace, File Management, AI, Frontend, API, Security
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name n8n Workflow Validator

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /chemin/absolu/vers/mcp-n8n-server/dist/server.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

1. Clonez ce dépôt ou naviguez vers le dossier du projet
2. Installez les dépendances :

pnpm install

3. Configurez les variables d'environnement :

cp .env.example .env

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

`N8nApiTool`

Interacts directly with the n8n API. Example usage includes making GET requests to endpoints like '/workflows' with parameters.

`WorkflowManagerTool`

Manages n8n workflows including listing, retrieving, creating, updating, deleting, exporting, and importing workflows. Example action includes 'list' with optional tags.

`NextJSIntegrationTool`

Generates NextJS integrations for n8n workflows. Example usage includes specifying the workflow ID, output directory, and options to generate TypeScript types and OpenAPI documentation.

`WorkflowValidatorTool`

Validates n8n workflows based on various criteria such as naming conventions, error handling, and security. Example usage includes specifying the workflow and the validators to apply.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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

3. 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

N8nApiTool

WorkflowManagerTool

NextJSIntegrationTool

WorkflowValidatorTool

Claude Desktop / Cursor

Linux

Macos

Windows

Serveur MCP pour n8n

Fonctionnalités

Prérequis

Installation

Utilisation

Construction du projet

Démarrage du serveur

Utilisation avec Claude Desktop

Structure du projet

Outils disponibles

1. N8nApiTool

2. WorkflowManagerTool

3. NextJSIntegrationTool

4. WorkflowValidatorTool

Contribution

Licence

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Time

Filesystem

`N8nApiTool`

`WorkflowManagerTool`

`NextJSIntegrationTool`

`WorkflowValidatorTool`