MikroMCP
MCP-сервер для MikroTik RouterOS и SwOS: 133 типизированных инструмента с пробным прогоном, снимками и откатом изменений.
- 103 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент может менять маршруты, правила межсетевого экрана и конфигурацию боевых роутеров, а при разрешении выполнять команды по SSH.
- Ключи доступа к роутерам хранятся в конфигурации сервера.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mikromcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может менять маршруты, правила межсетевого экрана и конфигурацию боевых роутеров, а при разрешении выполнять команды по SSH.
- Ключи доступа к роутерам хранятся в конфигурации сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MikroMCP открывает роутеры RouterOS и коммутаторы SwOS как набор из 133 типизированных MCP-инструментов. Агент смотрит состояние системы, интерфейсы, VLAN, адреса, DHCP, DNS, правила межсетевого экрана и NAT, маршруты, BGP и OSPF, читает журналы и запускает с самого роутера `ping`, `traceroute` и `torch`. Инструменты проверяют схему аргументов, делают записи идемпотентными и умеют показать запланированные изменения без применения. Защиту обеспечивают токены Bearer с хешами `bcrypt`, роли и ограничения по роутерам и инструментам, подтверждающие токены, журнал аудита и защищенное выполнение команд по SSH. Для безопасных изменений есть снимки, журнал записей, `plan_changes`, `apply_plan` и `rollback_change`. На каждый роутер приходится свой предохранитель от каскадных сбоев. Работает по stdio для настольных клиентов, а также по Streamable HTTP и SSE.
Для кого. Сетевым инженерам и администраторам MikroTik, которые хотят разбирать конфигурацию и диагностировать сеть через ассистента.
Подходит, если
- Нужно за один запрос получить состояние роутера, интерфейсы, маршруты и свежие ошибки в журнале.
- Правила межсетевого экрана надо проверить на отключенные и пересекающиеся пробросы портов, ничего не меняя.
- Новый маршрут сначала показывают в пробном прогоне с планом изменений и лишь затем применяют.
- Парком роутеров управляют несколько человек, и для каждого нужны свои права.
Не подходит, если
- Роутеры работают на RouterOS 6: сервер рассчитан на REST API версии 7.
- Коммутаторы SwOS нужны в рабочем режиме: поддержка помечена экспериментальной.
- Агенту нельзя выдавать доступ к боевой сети без человека в цикле.
Пример запроса к агенту
Проверь роутер `edge-01`: покажи отключенные правила межсетевого экрана и пересекающиеся пробросы портов, ничего пока не меняя.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
MIKROMCP_DEFAULT_ROUTER- Идентификатор роутера по умолчанию для установок с одним роутером.
Ограничения
Нужны Node.js 22 и RouterOS 7 с включенным REST API. Поддержка коммутаторов SwOS и SwOS Lite экспериментальная и построена на обратно разобранном HTTP-интерфейсе `.b`, поэтому записи в них идут с проверкой совместимости прошивки. Режимы HTTP и SSE требуют настройки токенов и ролей, а обычный запуск по stdio рассчитан на один роутер. Инструмент выполнения команд по SSH охраняется ограничениями, но остается опасным при широких правах: настройте для него права и подтверждения. Повторы выполняются только для инструментов чтения. Подробные руководства по установке и конфигурации лежат в вики проекта.
Как отключить. Удалите запись `mikromcp` из конфигурации клиента и пакет командой `npm uninstall -g mikromcp`. На роутере отзовите пользователя API, под которым работал сервер.
Частые вопросы
Как установить MikroMCP?
Выполните `npm install -g mikromcp`, затем `mikromcp init`. Для одного роутера по stdio этого достаточно, а для Docker и HTTP есть руководство в вики.
Как не допустить опасных изменений?
Используйте пробный прогон, `plan_changes`, подтверждающие токены и роли с ограничениями по роутерам и инструментам. Для отката есть `rollback_change` и снимки.
Какие транспорты поддерживаются?
stdio для настольных клиентов, а также Streamable HTTP и устаревший SSE для удаленных и сервисных сценариев.
Как указать роутер по умолчанию?
Задайте переменную `MIKROMCP_DEFAULT_ROUTER`: идентификатор роутера в запросах станет необязательным.
Есть ли скилл для Claude Code?
Да, в репозитории лежит скилл безопасной работы с инструментами. Он описан в вики на странице «Using the Skill».
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для роутеров MikroTik: агент читает и меняет конфигурацию RouterOS по SSH по запросу из чата
MCP-сервер для диагностики Linux: ИИ-клиент читает службы, журналы и сеть локальных и удаленных систем без права записи
MCP Slim Guard стоит между агентом и вашими MCP-серверами: проверяет вызовы по схеме и отдает большие ответы частями.
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
keenetic-mcp — управление роутером Keenetic
keenetic-mcp
MCP-сервер для роутеров Keenetic: агент смотрит устройства и Wi-Fi, меняет правила через API RCI и ничего не ставит на сам роутер
MCP-сервер подключает агента к сети UniFi для диагностики устройств, проверки настроек и согласованных изменений
Коротко о README
README объясняет, зачем нужен слой между агентом и роутером, перечисляет возможности по категориям, показывает примеры запросов и сравнивает сервер с прямым REST API и SSH. Установка, инструменты и конфигурация подробно описаны в вики.