n8n MCP Server

Servidor MCP para n8n

Este projeto é um servidor MCP (Master Control Program) para n8n que fornece ferramentas de validação de workflows e boas práticas para seus projetos de automação n8n.

Funcionalidades

• Validação de workflows : Verifique se seus workflows seguem as boas práticas
  • Convenções de nomenclatura
  • Gerenciamento de erros
  • Segurança
  • Performance
  • Documentação
• Integração NextJS : Gere integrações para seus workflows n8n em aplicações NextJS
  • Geração automática de rotas de API
  • Criação de documentação OpenAPI/Swagger
  • Geração de tipos TypeScript
  • Cliente de API para facilitar a integração
• Gerenciamento de workflows : Interaja com seus workflows n8n (listar, recuperar, criar, atualizar, excluir, exportar, importar)
• API n8n : Acesse diretamente a API n8n para operações avançadas
• Templates de workflows : Use templates prontos para diferentes casos de uso, incluindo Google Calendar

Pré-requisitos

• Node.js (v16 ou superior)
• pnpm (v7 ou superior)
• Uma instância n8n (local ou remota, como sua instância Cloudron em n8n.bienquoi.com)

Instalação

1. Clone este repositório ou navegue até a pasta do projeto
2. Instale as dependências:

pnpm install

3. Configure as variáveis de ambiente:

cp .env.example .env

Edite o arquivo .env com suas informações de conexão à API n8n.

Uso

Construção do projeto

pnpm build

Inicialização do servidor

pnpm start

O servidor MCP estará acessível em http://localhost:3000 (ou na porta especificada no seu arquivo .env).

Uso com Claude Desktop

Para usar este servidor MCP com Claude Desktop, você precisa configurar o arquivo claude_desktop_config.json na pasta %APPDATA%/Claude/:

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

Estrutura do projeto

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

Ferramentas disponíveis

1. N8nApiTool

Interage diretamente com a API n8n.

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

2. WorkflowManagerTool

Gerencia workflows n8n (lista, recupera, cria, atualiza, exclui, exporta, importa).

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

3. NextJSIntegrationTool

Gera integrações NextJS para workflows n8n.

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

4. WorkflowValidatorTool

Valida workflows n8n de acordo com diferentes critérios.

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

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue ou pull request.

Licença

MIT