MikroMCP

Automação de rede nativa de IA para MikroTik RouterOS. O MikroMCP expõe o RouterOS como um servidor de Protocolo de Contexto de Modelo tipado e auditável, permitindo que Claude, Cursor, Codex e outros clientes MCP inspecionem, diagnostiquem e operem com segurança roteadores MikroTik em linguagem natural.

GitHub
63
Experimente este MCPPatrocinado

Documentação

MikroMCP

MikroMCP

Automação de rede nativa para IA no MikroTik RouterOS. O MikroMCP expõe o RouterOS como um servidor Model Context Protocol tipado e auditável, para que Claude, Cursor, Codex e outros clientes MCP possam inspecionar, diagnosticar e operar roteadores MikroTik com segurança em linguagem natural.

CI Release Version License: MIT Node.js >= 22 RouterOS 7.x MCP Server Tools MikroMCP MCP server

O MikroMCP existe porque o acesso bruto à CLI do roteador é a abstração errada para agentes de IA. O RouterOS é poderoso, mas pedir a um LLM que improvise comandos de shell contra equipamentos de rede em produção é arriscado. O MikroMCP dá aos agentes uma superfície de ferramentas controlada: esquemas rígidos, gravações idempotentes, pré-visualizações de dry-run, disjuntores por roteador, políticas de repetição, RBAC, logs de auditoria, snapshots e fluxos de mudança com suporte a rollback.

Em uma frase: o MikroMCP transforma o MikroTik RouterOS em um plano de controle MCP voltado para produção, para infraestrutura de IA, automação de DevOps e gerenciamento moderno de roteadores.

AI assistant connected through MikroMCP to a small MikroTik fleet, with tool calls flowing through validation, audit, and RouterOS REST

Início Rápido

MikroMCP quick start: npm install -g mikromcp, mikromcp init, then ask Claude Desktop about your router

Essa é toda a configuração para uma implantação stdio de roteador único. Para binários autônomos, Docker, modo HTTP/SSE, pré-requisitos da API RouterOS e o passo a passo completo de 15 minutos, consulte o guia de Introdução.

Vitrine de Recursos

CategoriaO que o MikroMCP cobre
🧭 Gerenciamento de roteadorStatus do sistema, relógio, reinicialização, pacotes, arquivos, scripts, tarefas agendadas, contêineres
🌐 Operações de redeInterfaces, VLANs, endereços IP, leases DHCP, registros DNS estáticos, portas de bridge, clientes WiFi
🔥 Firewall e políticasRegras de filtro/NAT, regras mangle, listas de endereços, tabelas de rotas, regras de roteamento
🛰️ Visibilidade de roteamentoRotas estáticas, tabelas de roteamento, peers BGP, vizinhos OSPF
🔀 Switches SwOSExperimental. Switches MikroTik SwOS e SwOS Lite (deviceType: "swos") via API HTTP .b de engenharia reversa: links de porta, PoE, diagnósticos SFP e gravações de bloco inteiro protegidas com verificação de compatibilidade de firmware
🔐 Acesso seguroAutenticação por bearer HTTP, hashes de token bcrypt, RBAC, restrições de roteador/ferramenta, tokens de confirmação
🧪 Diagnósticosping, traceroute, torch originados no roteador, filtragem de logs, execução de comandos SSH protegida
🛡️ Segurança de mudançasDry-run, gravações idempotentes, snapshots, diário de gravação, plan_changes, apply_plan, rollback_change
⚙️ Comportamento de produçãoRepetições para ferramentas de leitura, disjuntores por roteador, IDs de correlação, logs estruturados, logs de auditoria
🤖 Adequação a agentes de IARespostas legíveis por humanos além de conteúdo JSON estruturado para raciocínio, encadeamento e automação; o servidor anuncia uma string instructions na inicialização do MCP para que os clientes se autoconfigurem; routerId resolvido via MIKROMCP_DEFAULT_ROUTER opcional para configurações de roteador único; habilidade de uso para uso seguro e guiado de ferramentas no Claude Code
🧩 Compatibilidade com MCPstdio para clientes desktop, HTTP Streamable e SSE legado para clientes remotos ou de serviço

122 ferramentas tipadas no total — veja o catálogo completo com parâmetros, padrões e exemplos de prompts prontos para copiar em Ferramentas Disponíveis.

Demonstração

Uso

Revisão pelo Claude

Claude Reviewed Router Configuration

Exemplos de Uso no Mundo Real

Inspeção de Roteador

Use MikroMCP to inspect core-01. Summarize system resources, RouterOS version,
running interfaces, active routes, DNS settings, and recent warning/error logs.
Flag anything that looks operationally risky.

Gerenciamento de Firewall

List firewall filter and NAT rules on edge-01. Identify disabled rules,
overlapping port forwards, broad accept rules, and anything without comments.
Do not change anything yet.

Mudança Segura de Rota Estática

Dry-run a route on core-01 for 10.20.0.0/16 via 192.168.88.1 in the main table.
Show the exact planned diff and tell me whether an existing route conflicts.

Operações WireGuard

Show WireGuard peers on branch-02. Sort by last handshake age and flag peers
that have not handshaken recently or have no transfer counters.

Diagnóstico de Interfaces

Check interface health on edge-01, then run ping and traceroute from the router
to 1.1.1.1. If packet loss is present, use torch on the WAN interface for a
short traffic snapshot.

Fluxo de Trabalho Plan / Apply / Rollback

Create a change plan that adds a DNS record and a firewall address-list entry
on edge-01. Use dry-run first, explain the plan, then wait for approval before
applying anything.

Por Que o MikroMCP É Útil para Agentes de IA

O MCP dá aos LLMs uma forma padrão de chamar ferramentas. O MikroMCP torna o RouterOS um alvo MCP de alta qualidade ao transformar operações de rede em ações bem descritas, legíveis por máquina e cientes de permissões.

Assistentes de IA podem usar o MikroMCP para:

  • Investigar o estado do roteador sem memorizar a sintaxe de comandos do RouterOS.
  • Encadear chamadas de ferramentas entre interfaces, rotas, regras de firewall, logs e diagnósticos.
  • Retornar tanto resumos amigáveis ao operador quanto JSON estruturado para raciocínio posterior.
  • Pré-visualizar mudanças antes da mutação e explicar exatamente o que aconteceria.
  • Respeitar autorização em nível de ferramenta, escopo de roteador, janelas de manutenção e portões de confirmação.

FAQ

O que é o MikroMCP?

O MikroMCP é um servidor Model Context Protocol (MCP) de código aberto que expõe o MikroTik RouterOS como 122 ferramentas tipadas e auditáveis — permitindo que assistentes de IA inspecionem, diagnostiquem e operem roteadores com segurança em linguagem natural, em vez de improvisar comandos de CLI.

MikroMCP vs API RouterOS

A API REST/API do RouterOS expõe endpoints brutos. O MikroMCP os envolve em ferramentas validadas por esquema, idempotentes e com suporte a dry-run, com RBAC, logs de auditoria, snapshots e rollback — a camada de segurança que um LLM precisa antes de tocar em equipamentos de produção.

MikroMCP vs automação por SSH

Em vez de scripts SSH frágeis que fazem screen-scrape da saída da CLI, o MikroMCP retorna resultados estruturados e tipados, com portões de confirmação e disjuntores por roteador. O SSH é usado apenas onde o REST não alcança — ping, traceroute, torch e run_command protegido.

MikroMCP para Claude Code

O MikroMCP fala MCP via stdio e HTTP/SSE, então Claude Code e Claude Desktop controlam o RouterOS diretamente. Combine-o com a habilidade de uso incluída para fluxos de trabalho seguros e guiados.

MikroMCP para Codex

O Codex conecta-se ao MikroMCP pelo protocolo MCP padrão — veja Conectando a Assistentes de IA.

MikroMCP para Cursor

O Cursor conecta-se ao MikroMCP como servidor MCP (stdio ou HTTP) para inspecionar e gerenciar roteadores MikroTik sem sair do editor.

MikroMCP para OpenClaw

Qualquer cliente compatível com MCP — incluindo o OpenClaw — pode usar o MikroMCP; configure-o como servidor MCP stdio ou HTTP.

Guia de Automação de IA para RouterOS

Comece com Introdução para instalar e conectar, depois use a habilidade de uso e as Ferramentas Disponíveis para automatizar o RouterOS com segurança usando um assistente de IA.

Melhores Servidores MCP para Engenheiros de Rede

O MikroMCP é construído especificamente para operações MikroTik/RouterOS com segurança de nível de produção — dry-run, rollback, auditoria e RBAC — tornando-o uma forte opção de MCP para engenheiros de rede que adotam ferramentas de IA.

Documentação

O README é mantido intencionalmente curto. Tudo abaixo está documentado em profundidade na wiki:

RecursoUse para
IntroduçãoInstalar (npm, binário, Docker), configurar e conectar em 15 minutos
Configuração da API RouterOSHabilitar a API REST, criar um usuário, TLS e firewall
ConfiguraçãoRegistro de roteadores, credenciais, todas as variáveis de ambiente
ExecuçãoExecutar comandos, transporte HTTP/SSE, solução de problemas
Conectando ao Claude DesktopRegistrar o MikroMCP no Claude Desktop
Conectando a Assistentes de IAClaude Code, Cursor, Codex, HTTP/Docker/systemd
Usando a HabilidadeInstalar a habilidade de uso do MikroMCP para que seu assistente use as ferramentas com segurança
Ferramentas DisponíveisTodas as 122 ferramentas — parâmetros e exemplos de prompts
ArquiteturaCamadas do sistema, pipeline de requisições, modelo de autenticação
Tratamento de ErrosCategorias de erro, mecanismo de repetição, disjuntor
SegurançaModelo de ameaças, checklist de endurecimento, relato de vulnerabilidades
DesenvolvimentoEstrutura do projeto, testes, fluxo de trabalho do MCP Inspector
ContribuindoAdicionar ferramentas, convenções de código, checklist de PR
Roadmap · ROADMAP.mdMarcos entregues e princípios orientadores

Contribuindo

Issues, relatos de bugs, solicitações de ferramentas, melhorias de documentação e pull requests são bem-vindos.

Boas primeiras contribuições:

  • Adicionar uma ferramenta somente leitura para uma superfície do RouterOS ainda não coberta.
  • Adicionar capturas de tela, GIFs de demonstração ou diagramas de topologia.
  • Expandir testes em torno da normalização de respostas do RouterOS e casos extremos de idempotência.
  • Ajudar a validar a compatibilidade de versões do RouterOS em dispositivos MikroTik reais e CHR.

Padrões de desenvolvimento:

  • TypeScript em modo estrito, imports ESM com extensões .js
  • Esquemas Zod com .strict(), idempotência e dryRun para ferramentas de gravação
  • MikroMCPError para erros de domínio, cobertura Vitest focada para cada ferramenta

Abra uma issue antes de mudanças grandes para que os mantenedores possam alinhar o escopo.

Agradecimentos

  • @f0086 — suporte a switches SwOS / SwOS Lite (v1.9.0), que levou o MikroMCP além do RouterOS pela primeira vez.

Segurança

O MikroMCP controla dispositivos de rede reais — trate-o como um sistema de operações: usuários RouterOS com privilégios mínimos, TLS verificado (ou impressões digitais fixadas), credenciais apenas em ~/.mikromcp/.env, identidades RBAC com escopo e logs de auditoria para uso compartilhado. O checklist completo de endurecimento e o processo de relato de vulnerabilidades estão na página de Segurança.

Comunidade e Suporte

  • ⭐ Dê uma estrela no repositório se o MikroMCP ajudar seu fluxo de trabalho MikroTik ou MCP.
  • 🍴 Faça um fork para adicionar superfícies RouterOS das quais sua rede depende.
  • 🧵 Abra uma issue para bugs, solicitações de recursos, notas de compatibilidade ou lacunas na documentação.

Licença

O MikroMCP é distribuído sob a Licença MIT.