MikroMCP

Automatización de red nativa de IA para MikroTik RouterOS. MikroMCP expone RouterOS como un servidor de Protocolo de Contexto de Modelo tipado y auditable, permitiendo que Claude, Cursor, Codex y otros clientes MCP inspeccionen, diagnostiquen y operen de forma segura routers MikroTik en lenguaje natural.

GitHub
63
Prueba este MCPPatrocinado

Documentación

MikroMCP

MikroMCP

Automatización de redes nativa para IA en MikroTik RouterOS. MikroMCP expone RouterOS como un servidor tipado y auditable de Model Context Protocol para que Claude, Cursor, Codex y otros clientes MCP puedan inspeccionar, diagnosticar y operar de forma segura routers MikroTik en lenguaje natural.

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

MikroMCP existe porque el acceso directo a la CLI del router es la abstracción incorrecta para agentes de IA. RouterOS es potente, pero pedirle a un LLM que improvise comandos de shell contra equipos de red en producción es arriesgado. MikroMCP ofrece a los agentes una superficie de herramientas controlada: esquemas estrictos, escrituras idempotentes, vistas previas en modo simulación, interruptores de circuito por router, políticas de reintento, RBAC, registros de auditoría, instantáneas y flujos de cambio con capacidad de reversión.

En una frase: MikroMCP convierte MikroTik RouterOS en un plano de control MCP orientado a producción para infraestructura de IA, automatización de DevOps y gestión moderna de routers.

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

Inicio Rápido

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

Esa es toda la configuración para un despliegue stdio de un solo router. Para binarios independientes, Docker, modo HTTP/SSE, los requisitos de la API de RouterOS y el recorrido completo de 15 minutos, consulta la guía de Inicio Rápido.

Demostración de Funcionalidades

CategoríaLo que cubre MikroMCP
🧭 Gestión del routerEstado del sistema, reloj, reinicio, paquetes, archivos, scripts, trabajos programados, contenedores
🌐 Operaciones de redInterfaces, VLANs, direcciones IP, concesiones DHCP, registros DNS estáticos, puertos de bridge, clientes WiFi
🔥 Firewall y políticasReglas de filtro/NAT, reglas mangle, listas de direcciones, tablas de rutas, reglas de enrutamiento
🛰️ Visibilidad de enrutamientoRutas estáticas, tablas de enrutamiento, peers BGP, vecinos OSPF
🔀 Switches SwOSExperimental. Switches MikroTik SwOS y SwOS Lite (deviceType: "swos") a través de la API HTTP .b de ingeniería inversa: enlaces de puertos, PoE, diagnósticos SFP y escrituras completas de blob protegidas con verificación de compatibilidad de firmware
🔐 Acceso seguroAutenticación HTTP bearer, hashes de tokens bcrypt, RBAC, restricciones de router/herramienta, tokens de confirmación
🧪 Diagnósticosping, traceroute, torch originados en el router, filtrado de registros, ejecución de comandos SSH protegida
🛡️ Seguridad de cambiosModo simulación, escrituras idempotentes, instantáneas, diario de escrituras, plan_changes, apply_plan, rollback_change
⚙️ Comportamiento de producciónReintentos para herramientas de lectura, interruptores de circuito por router, IDs de correlación, registros estructurados, registros de auditoría
🤖 Ajuste para agentes de IARespuestas legibles por humanos más contenido JSON estructurado para razonamiento, encadenamiento y automatización; el servidor anuncia una cadena instructions en la inicialización de MCP para que los clientes se autoconfiguren; routerId resuelto mediante MIKROMCP_DEFAULT_ROUTER opcional para configuraciones de un solo router; habilidad de uso para uso seguro y guiado de herramientas en Claude Code
🧩 Compatibilidad MCPstdio para clientes de escritorio, HTTP Streamable y SSE heredado para clientes remotos o de tipo servicio

122 herramientas tipadas en total — explora el catálogo completo con parámetros, valores predeterminados y ejemplos de prompts copiables en Herramientas Disponibles.

Demostración

Uso

Revisión por Claude

Claude Reviewed Router Configuration

Ejemplos de Uso en el Mundo Real

Inspección del Router

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.

Gestión del 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.

Cambio Seguro de Ruta 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.

Operaciones con 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ósticos de Interfaz

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.

Flujo de Trabajo Planificar / Aplicar / Revertir

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 Qué MikroMCP Es Útil Para Agentes de IA

MCP ofrece a los LLM una forma estándar de llamar herramientas. MikroMCP convierte RouterOS en un objetivo MCP de alta calidad al transformar las operaciones de red en acciones bien descritas, legibles por máquina y conscientes de permisos.

Los asistentes de IA pueden usar MikroMCP para:

  • Investigar el estado del router sin memorizar la sintaxis de comandos de RouterOS.
  • Encadenar llamadas a herramientas entre interfaces, rutas, reglas de firewall, registros y diagnósticos.
  • Devolver tanto resúmenes aptos para operadores como JSON estructurado para razonamiento posterior.
  • Previsualizar cambios antes de la mutación y explicar exactamente qué ocurriría.
  • Respetar la autorización a nivel de herramienta, el alcance del router, las ventanas de mantenimiento y las puertas de confirmación.

Preguntas Frecuentes

¿Qué es MikroMCP?

MikroMCP es un servidor de código abierto de Model Context Protocol (MCP) que expone MikroTik RouterOS como 122 herramientas tipadas y auditables — permitiendo a los asistentes de IA inspeccionar, diagnosticar y operar routers de forma segura en lenguaje natural en lugar de improvisar comandos CLI.

MikroMCP vs API de RouterOS

La API REST de RouterOS expone endpoints sin procesar. MikroMCP los envuelve en herramientas validadas por esquema, idempotentes y con modo simulación, con RBAC, registro de auditoría, instantáneas y reversión — la capa de seguridad que un LLM necesita antes de tocar equipos en producción.

MikroMCP vs automatización por SSH

En lugar de scripts SSH frágiles que extraen texto de la salida CLI, MikroMCP devuelve resultados estructurados y tipados con puertas de confirmación e interruptores de circuito por router. SSH se usa solo donde REST no llega — ping, traceroute, torch y run_command protegido.

MikroMCP para Claude Code

MikroMCP habla MCP sobre stdio y HTTP/SSE, por lo que Claude Code y Claude Desktop controlan RouterOS directamente. Combínalo con la habilidad de uso incluida para flujos de trabajo seguros y guiados.

MikroMCP para Codex

Codex se conecta a MikroMCP mediante el protocolo MCP estándar — consulta Conexión a Asistentes de IA.

MikroMCP para Cursor

Cursor se conecta a MikroMCP como servidor MCP (stdio o HTTP) para inspeccionar y gestionar routers MikroTik sin salir del editor.

MikroMCP para OpenClaw

Cualquier cliente compatible con MCP — incluido OpenClaw — puede usar MikroMCP; configúralo como servidor MCP stdio o HTTP.

Guía de Automatización de IA para RouterOS

Comienza con Inicio Rápido para instalar y conectar, luego usa la habilidad de uso y Herramientas Disponibles para automatizar RouterOS de forma segura con un asistente de IA.

Mejores Servidores MCP para Ingenieros de Red

MikroMCP está diseñado específicamente para operaciones MikroTik/RouterOS con seguridad de nivel producción — modo simulación, reversión, auditoría y RBAC — lo que lo convierte en una opción MCP sólida para ingenieros de red que adoptan herramientas de IA.

Documentación

El README se mantiene intencionalmente breve. Todo lo siguiente está documentado en profundidad en la wiki:

RecursoPara qué usarlo
Inicio RápidoInstalar (npm, binario, Docker), configurar y conectar en 15 minutos
Configuración de la API de RouterOSHabilitar la API REST, crear un usuario, TLS y firewall
ConfiguraciónRegistro de routers, credenciales, todas las variables de entorno
EjecuciónEjecutar comandos, transporte HTTP/SSE, solución de problemas
Conexión a Claude DesktopRegistrar MikroMCP en Claude Desktop
Conexión a Asistentes de IAClaude Code, Cursor, Codex, HTTP/Docker/systemd
Uso de la HabilidadInstalar la habilidad de uso de MikroMCP para que tu asistente maneje las herramientas de forma segura
Herramientas DisponiblesLas 122 herramientas — parámetros y ejemplos de prompts
ArquitecturaCapas del sistema, pipeline de solicitudes, modelo de autenticación
Manejo de ErroresCategorías de error, motor de reintentos, interruptor de circuito
SeguridadModelo de amenazas, lista de verificación de endurecimiento, reporte de vulnerabilidades
DesarrolloEstructura del proyecto, pruebas, flujo de trabajo con MCP Inspector
ContribucionesAñadir herramientas, convenciones de código, lista de verificación de PR
Hoja de Ruta · ROADMAP.mdHitos alcanzados y principios rectores

Contribuciones

Se aceptan problemas, informes de errores, solicitudes de herramientas, mejoras de documentación y solicitudes de extracción.

Buenas primeras contribuciones:

  • Añadir una herramienta de solo lectura para una superficie de RouterOS no cubierta.
  • Añadir capturas de pantalla, GIFs de demostración o diagramas de topología.
  • Ampliar las pruebas en torno a la normalización de respuestas de RouterOS y casos límite de idempotencia.
  • Ayudar a validar la compatibilidad de versiones de RouterOS en dispositivos MikroTik reales y CHR.

Estándares de desarrollo:

  • Modo estricto de TypeScript, importaciones ESM con extensiones .js
  • Esquemas Zod con .strict(), idempotencia y dryRun para herramientas de escritura
  • MikroMCPError para errores de dominio, cobertura enfocada de Vitest para cada herramienta

Abre un problema antes de cambios grandes para que los mantenedores puedan alinear el alcance.

Agradecimientos

  • @f0086 — soporte para switches SwOS / SwOS Lite (v1.9.0), que llevó a MikroMCP más allá de RouterOS por primera vez.

Seguridad

MikroMCP controla dispositivos de red reales — trátalo como un sistema de operaciones: usuarios de RouterOS con privilegios mínimos, TLS verificado (o huellas digitales fijadas), credenciales solo en ~/.mikromcp/.env, identidades RBAC con alcance y registro de auditoría para uso compartido. La lista de verificación completa de endurecimiento y el proceso de reporte de vulnerabilidades están en la página de Seguridad.

Comunidad y Soporte

  • ⭐ Marca el repositorio con una estrella si MikroMCP ayuda a tu flujo de trabajo MikroTik o MCP.
  • 🍴 Haz un fork para añadir superficies de RouterOS de las que tu red depende.
  • 🧵 Abre un problema para errores, solicitudes de funciones, notas de compatibilidad o brechas de documentación.

Licencia

MikroMCP se publica bajo la Licencia MIT.