n8n-mcp-server: ferramenta de serviço MCP para interagir com fluxos de trabalho n8n

Introdução geral

O n8n-mcp-server é um projeto de código aberto hospedado no GitHub e desenvolvido por Leonard Sellem. É uma ferramenta de serviço MCP (Model Context Protocol) projetada especificamente para interagir com os fluxos de trabalho do n8n. O n8n é uma plataforma de fluxo de trabalho automatizado, e essa ferramenta é usada para essa finalidade por meio do MCP Um protocolo que permite que os assistentes de IA operem diretamente com o n8n. Você pode usá-lo para criar, executar e gerenciar fluxos de trabalho do n8n. Destina-se a pessoas que desejam simplificar as tarefas de automação com IA, como desenvolvedores ou equipes. O projeto tem uma atualização em março de 2025, o que significa que está bem mantido.

Lista de funções

• Conecte o n8n por meio do protocolo MCP para dar aos assistentes de IA o controle direto do fluxo de trabalho.
• Suporte para criação e modificação de fluxos de trabalho n8n.
• Você pode executar o fluxo de trabalho n8n e visualizar os resultados.
• Configure as informações de conexão do n8n com variáveis de ambiente.
• Design de código aberto, o código pode ser ajustado livremente.

Usando a Ajuda

Etapas de instalação

Para usar o n8n-mcp-server, você precisa instalá-lo primeiro. Aqui estão as etapas exatas:

1. Ferramentas de preparação
   Certifique-se de ter o Node.js em seu computador (recomenda-se a versão 18 ou superior). Você também precisará de uma instância em execução do n8n com a funcionalidade de API ativada. Vá para as configurações do n8n e procure a chave de API.
2. Download do projeto
   Digite-o no terminal:

git clone https://github.com/leonardsellem/n8n-mcp-server.git

Em seguida, vá para o catálogo:

cd n8n-mcp-server

3. Instalação de dependências
   Execute este comando:

npm install

Ele carregará os arquivos necessários para o projeto.

4. Definição de variáveis de ambiente
   Copie o arquivo de exemplo:

cp .env.example .env

show (um ingresso) .env preencha as informações do n8n, por exemplo:

N8N_API_URL=http://localhost:5678/api/v1
N8N_API_KEY=你的n8n密钥
DEBUG=false

• N8N_API_URL é o endereço de n8n.
• N8N_API_KEY Essa é a chave.
• DEBUG configurado como true Você pode ver mais registros.

5. compilar código
   Entrada:

npm run build

Isso transformará o código em um arquivo executável.

6. Início dos serviços
   Em execução:

npm start

O serviço é iniciado e o assistente de IA pode se comunicar com ele por meio de entradas e saídas padrão.

Como usar os principais recursos

Depois de instalado, o n8n-mcp-server se torna um serviço MCP. Sua principal função é permitir que a IA interaja com o fluxo de trabalho do n8n. Veja como fazer isso:

• Conectando-se à IA
  Você precisa adicionar esse serviço à plataforma de IA. Por exemplo, em uma ferramenta que ofereça suporte a MCP, edite o arquivo de configuração para adicioná-lo:

{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_API_URL": "你的n8n地址",
"N8N_API_KEY": "你的密钥"
}
}
}
}

Uma vez salvo, a IA poderá encontrar esse serviço.

• Criação de fluxos de trabalho
  Você pode dizer à IA: "Crie um fluxo de trabalho na n8n para mim e envie-o por e-mail todos os dias". A IA enviará a solicitação à n8n, por meio do serviço MCP, para criá-lo automaticamente.
• Execução de fluxos de trabalho
  Diga: "Executar meu fluxo de trabalho de correio eletrônico". O serviço diz ao n8n para executar a tarefa e, em seguida, retorna um resultado, como "tarefa concluída" ou "algo deu errado".
• verificar status
  Pergunte: "Como meu fluxo de trabalho está sendo executado?" O serviço verificará o status do n8n e lhe dirá exatamente.
• Problemas de depuração
  Se não funcionar corretamente, coloque .env interno DEBUG adaptar (uma história para outra mídia) trueReinicie o serviço e você poderá ver os registros detalhados. Os desenvolvedores também podem alterar o código para adicionar recursos.

dica

• n8n Se estiver sendo executado localmente, o endereço geralmente é http://localhost:5678/api/v1.
• Mantenha a chave em segredo, não a mostre a qualquer pessoa.
• Você pode executar o n8n com o Docker da mesma forma que o .env Basicamente.

cenário do aplicativo

1. tarefa cronometrada
   Você pode usá-lo como um fluxo de trabalho para verificar o clima todos os dias e, em seguida, enviar um lembrete de texto.
2. processamento de dados
   Na empresa, você pode usá-lo para organizar automaticamente os dados de vendas e gerar formulários para enviar ao grupo. Operação com IA, economizando tempo e esforço.
3. desenvolvimento de testes
   Os desenvolvedores podem usá-lo para testar como a IA e o n8n funcionam juntos e alterar o código para experimentar novas ideias.

QA

1. Preciso saber programar?
   Não há problema se você não souber como fazer isso, basta saber como carregar coisas a partir da linha de comando. Mas você precisa saber JavaScript para alterar as funções.
2. O que há de tão especial nesse serviço?
   Ele permite que a IA gerencie diretamente os fluxos de trabalho n8n sem que você tenha que tocar manualmente.
3. Quantos n8n você pode conectar?
   Qualquer número deles. Basta atribuir um endereço n8n a cada serviço e executar várias instâncias.