MCP Server for n8n

This project is a Master Control Program (MCP) server for n8n that provides workflow validation tools and best practices for your n8n automation projects.

Features

• Workflow Validation : Check that your workflows follow best practices

  • Naming conventions

  • Error handling

  • Security

  • Performance

  • Documentation

• NextJS Integration : Generate integrations for your n8n workflows into NextJS applications

  • Automatic generation of API routes

  • Creating OpenAPI/Swagger documentation

  • TypeScript Type Generation

  • API client to facilitate integration

• Workflow management : Interact with your n8n workflows (list, retrieve, create, update, delete, export, import)

• n8n API : Directly access the n8n API for advanced operations

• Workflow Templates : Use ready-made templates for different use cases, including Google Calendar

Related MCP server: mcp-n8n-builder

Prerequisites

• Node.js (v16 or higher)

• pnpm (v7 or higher)

• An n8n instance (local or remote like your Cloudron instance at n8n.bienquoi.com)

Facility

1. Clone this repository or navigate to the project folder

2. Install the dependencies:

pnpm install

3. Configure the environment variables:

cp .env.example .env

Edit the .env file with your n8n API connection information.

Use

Construction of the project

pnpm build

Server Startup

pnpm start

The MCP server will be accessible at http://localhost:3000 (or the port specified in your .env file).

Use with Claude Desktop

To use this MCP server with Claude Desktop, you need to configure the claude_desktop_config.json file in the %APPDATA%/Claude/ folder:

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

Project structure

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

Available tools

1. N8nApiTool

Interacts directly with the n8n API.

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

2. WorkflowManagerTool

Manages n8n workflows (list, retrieve, create, update, delete, export, import).

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

3. NextJSIntegrationTool

Generates NextJS integrations for n8n workflows.

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

4. WorkflowValidatorTool

Validates n8n workflows based on various criteria.

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

Contribution

Contributions are welcome! Feel free to open an issue or a pull request.

License

MIT