MikroTik MCP for n8n

Fork do mikrotik-mcp configurado para rodar como container Docker com transporte SSE, pronto para integração com n8n.

O que muda neste fork

• Transporte SSE por padrão — o container já sobe em modo SSE (HTTP), sem precisar configurar
• Docker Compose pronto — aponte o Portainer para este repo e deploy
• Log configurável — variável LOG_LEVEL para debug sem rebuild
• Documentação em PT-BR — instruções completas em README-N8N.md

Arquitetura

┌─────────────────┐     HTTP/SSE      ┌─────────────────────┐     SSH      ┌──────────────┐
│    n8n           │ ──────────────►   │  mikrotik-mcp:8000  │ ──────────►  │  MikroTik    │
│  (AI Agent)      │   porta 3000     │  (Docker Container) │  porta 22   │  Router      │
└─────────────────┘                   └─────────────────────┘              └──────────────┘

Quick Start

1. Deploy via Portainer (recomendado)

1. Stacks → Add Stack
2. Repository: https://github.com/Foninhoiuri/mcp-mikrotik-for-n8n.git
3. Compose path: docker-compose.yml
4. Ajuste as variáveis de ambiente (IP, usuário, senha do MikroTik)
5. Deploy the stack

2. Deploy manual

git clone https://github.com/Foninhoiuri/mcp-mikrotik-for-n8n.git
cd mcp-mikrotik-for-n8n

# Edite o docker-compose.yml com suas credenciais
docker compose up -d

3. Conectar no n8n

1. No n8n, vá em Settings → MCP Servers
2. Transporte: SSE
3. URL: http://IP_DO_SEU_SERVIDOR:3000/sse

As ferramentas do MikroTik aparecem automaticamente no AI Agent.

Variáveis de Ambiente

Variável	Padrão	Descrição
MIKROTIK_HOST	192.168.88.1	IP do roteador MikroTik
MIKROTIK_USERNAME	admin	Usuário SSH
MIKROTIK_PASSWORD	(vazio)	Senha SSH
MIKROTIK_PORT	22	Porta SSH
MIKROTIK_MCP__TRANSPORT	sse	Transporte: sse, streamable-http, stdio
MIKROTIK_MCP__ALLOWED_HOSTS	(vazio)	Use * para rede local
LOG_LEVEL	INFO	Nível de log: DEBUG, INFO, WARNING, ERROR
N8N_NETWORK_NAME	n8n_default	Nome da rede Docker do seu n8n para comunicação interna

Ferramentas disponíveis

Todas as 173+ tools do projeto original, incluindo:

• 🔥 Firewall — regras de filter e NAT
• 🌐 DNS — registros estáticos e configurações
• 📡 DHCP — leases e configuração de servidor
• 🔒 WireGuard — peers e interfaces VPN
• 🖧 Interfaces — VLANs, bridges, ethernet
• 📊 Queues — controle de banda
• 🗂️ Backup — export e backup do sistema
• 👥 Usuários — gerenciamento de contas
• 📋 Logs — consulta de logs do sistema
• 🛣️ Rotas — tabela de roteamento

Documentação completa

📚 Veja README-N8N.md para instruções detalhadas incluindo:

• Deploy via Portainer
• Configuração multi-device (vários MikroTiks)
• Troubleshooting

Créditos

Baseado no projeto mikrotik-mcp por Jeff Nasseri.

Licença

MIT License — veja LICENSE.