N8N2MCP: ferramenta automatizada para converter fluxos de trabalho n8n em servidores MCP

O N8N2MCP é uma ferramenta de código aberto projetada para ajudar os usuários a converter fluxos de trabalho n8n em Modelo de protocolo de contexto (MCP). Ele permite que os usuários criem processos automatizados por meio do editor visual do n8n e os implementem rapidamente como servidores MCP que se integram perfeitamente aos assistentes de IA, como Claude, Cursor ou Super Chain. Os usuários podem simplesmente configurar os assistentes de IA para invocar esses fluxos de trabalho como ferramentas personalizadas. O n8N2MCP fornece uma plataforma de gerenciamento de fluxo de trabalho baseada na Web e um sistema de roteamento MCP eficiente para desenvolvedores ou equipes que precisam implantar rapidamente tarefas automatizadas. O projeto está hospedado no GitHub em um modelo de código aberto que incentiva os usuários a contribuir com código e feedback.

Lista de funções

• Converta fluxos de trabalho n8n em servidores MCP para oferecer suporte a chamadas de assistente de IA.
• Oferece uma interface da Web para facilitar o gerenciamento, a implementação e a configuração de fluxos de trabalho.
• Oferece suporte à implementação com um clique para gerar servidores MCP hospedados localmente.
• O roteador MCP integrado garante a criação eficiente de servidores e o processamento de solicitações.
• Oferece suporte à integração com plataformas como Claude, Cursor e Super Chain.
• Fornece mecanismos de gerenciamento de segurança, incluindo gerenciamento de credenciais, rotação de chaves de API e suporte a HTTPS.
• Suporta o banco de dados Supabase para armazenar a configuração do usuário e os dados do fluxo de trabalho.
• Use o Playwright para autenticação n8n e automação do navegador.

Usando a Ajuda

Processo de instalação

Para usar o N8N2MCP, você precisa concluir a instalação e a configuração localmente ou no servidor. Veja a seguir as etapas detalhadas:

1. Clonagem da base de código
   Execute o seguinte comando no terminal para clonar o projeto N8N2MCP localmente:

   git clone https://github.com/Super-Chain/N8N2MCP.git
   cd N8N2MCP
   

2. Instalação de dependências
   Use o gerenciador de pacotes Python para instalar as dependências necessárias para o seu projeto:

   pip install -r requirements.txt
   

3. Instalar o navegador Playwright
   O N8N2MCP depende do Playwright para autenticação e automação do n8n. Execute o seguinte comando para instalar o binário do navegador:

   playwright install
   

   Observação: se o Playwright não estiver instalado corretamente, o sistema usará as credenciais padrão, resultando em funcionalidade limitada.

4. Configuração de variáveis de ambiente
   Copie o arquivo de configuração de ambiente de amostra e edite-o:

   cp .env.example .env
   

   Abrir com um editor de texto .env preencha a seguinte configuração de chave:

   • Configuração do Supabase:

     SUPABASE_URL=https://your-project-id.supabase.co
     SUPABASE_KEY=your_supabase_anon_key
     SUPABASE_SERVICE_KEY=your_supabase_service_role_key
     

   • Configuração n8n:

     X_N8N_API_KEY=your_n8n_api_key
     N8N_BASE_URL=https://your-n8n-instance.com
     N8N_USERNAME=your_n8n_username
     N8N_PASSWORD=your_n8n_password
     

   • Configuração do roteador MCP:

     N8N_BUILDER_URL=http://localhost:6545
     FLASK_HOST=0.0.0.0
     FLASK_PORT=5000
     MCP_HOST=0.0.0.0
     MCP_PORT=6545
     

   Substitua pelos valores reais de configuração para garantir que a instância n8n e o serviço Supabase estejam acessíveis.

5. Executando o roteador MCP
   Inicie o roteador MCP para processar a solicitação:

   cd mcp_router
   python mcp_router.py --log-level debug
   

   Modo de depuração (--log-level debug) Os registros detalhados podem ser visualizados para facilitar a solução de problemas.

6. item de teste
   Teste se o analisador de fluxo de trabalho e o roteador MCP estão funcionando corretamente:

   python -m agent_marketplace.n8n_workflow_parser
   python -m mcp_router.mcp_router
   

Funções principais

1. conversão de fluxos de trabalho n8n para servidores MCP

• Crie ou edite fluxos de trabalho na interface n8n e projete tarefas automatizadas usando o editor visual.
• Por meio da interface da Web do N8N2MCP (que é executada por padrão no http://localhost:5000) upload n8n fluxo de trabalho Arquivo JSON ou link de modelo.
• Quando você clica no botão Deploy, o sistema analisa o fluxo de trabalho e gera um servidor MCP. Depois de gerado, o sistema retorna um URL do servidor (por exemplo http://localhost:6545).
• Cole esse URL em um assistente de IA habilitado para MCP (como o Claude (ou Cursor) para chamar a funcionalidade do fluxo de trabalho.

2. gerenciar o servidor MCP

• Visite o Agent Marketplace (interface da Web) para visualizar uma lista de servidores MCP implantados.
• O servidor pode ser pausado, excluído ou reconfigurado, e suporta o ajuste dinâmico dos parâmetros do fluxo de trabalho.
• Use o banco de dados do Supabase para gerenciar as configurações e os dados do usuário, garantindo o isolamento e a segurança dos dados.

3. integração de assistentes de IA

• Adicione o URL do servidor MCP como uma ferramenta personalizada em Claude, Cursor ou Super Chain.
• O assistente de IA chama o servidor por meio do protocolo MCP para executar tarefas no fluxo de trabalho, como processamento de dados, chamadas de API ou automação.
• Exemplo: se o fluxo de trabalho incluir a capacidade de enviar um e-mail, o AI Assistant poderá acionar o envio do e-mail diretamente.

4. gerenciamento de segurança

• Altere regularmente a chave API n8n e a chave Supabase para garantir a segurança.
• Ative o HTTPS em ambientes de produção e use certificados SSL para proteger as transferências de dados.
• Configure políticas de segurança em nível de linha (RLS) para garantir o isolamento dos dados do usuário.

advertência

• Certifique-se de que a instância do n8n esteja em funcionamento e possa ser acessada por meio do N8N_BASE_URL Acesso.
• A instalação e a configuração do Playwright são essenciais para a autenticação n8n e a falha na configuração correta pode resultar em funcionalidade limitada.
• O modo de depuração do Flask pode ser ativado para depuração:

  export FLASK_DEBUG=1
  

• sonda .env para todos os itens de configuração para evitar falhas na implementação devido a erros de configuração.

cenário do aplicativo

1. Tarefas de marketing automatizadas
   Os desenvolvedores podem projetar fluxos de trabalho n8n para automatizar a entrega de e-mails de marketing ou analisar dados de assinantes e, uma vez convertido em um servidor MCP, o assistente de IA pode acionar e-mails personalizados com base no comportamento do cliente.
2. Processamento e integração de dados
   Os analistas de dados podem usar o N8N2MCP para implantar processos complexos de processamento de dados, como rastrear dados de APIs e armazená-los em bancos de dados, como servidores MCP para os assistentes de IA chamarem para gerar relatórios.
3. Aprimoramento do AI Assistant
   Claude ou Cursor Com o N8N2MCP, os usuários podem ampliar os recursos de IA, como a integração de fluxos de trabalho n8n ao assistente de IA para gerenciamento de arquivos, análise de dados ou geração de código.
4. Prototipagem rápida
   As startups podem aproveitar o N8N2MCP para implementar rapidamente protótipos automatizados, testar processos de negócios e validar a viabilidade de recursos com assistentes de IA.

QA

1. Quais assistentes de IA são compatíveis com o N8N2MCP?
   Atualmente, ele oferece suporte a assistentes de IA compatíveis com MCP, como Claude, Cursor e Super Chain. Ele poderá ser estendido a mais plataformas no futuro.
2. É necessário ter experiência n8n para usá-lo?
   É necessário ter um conhecimento básico da criação do fluxo de trabalho do n8n, mas a interface da Web do N8N2MCP simplifica o processo de implementação sem conhecimento profundo de programação.
3. Como posso garantir a segurança do servidor?
   Recomenda-se usar HTTPS, alternar as chaves de API regularmente, ativar políticas de RLS e evitar o armazenamento de credenciais de usuário no lado do servidor.
4. E se o Playwright não for instalado?
   Verifique as conexões de rede para garantir a operação playwright install comando. Se isso não funcionar, tente fazer o download do binário do navegador manualmente ou entre em contato com o suporte da comunidade.