MikroTik MCP: настройка роутера агентом в Claude, Codex и Cursor

wiresage/mikrotik-mcp· Проверено 12.11.2026· 334на GitHub

Подключает агента к роутерам MikroTik по SSH: интерфейсы, VLAN, адреса, DHCP, DNS, файрвол, NAT, WireGuard, бэкапы и логи. Рискованные правки можно вносить в Safe Mode с автооткатом.

3 реализации:

Пакет PyPI mcp-server-mikrotik: инструменты под меню RouterOS 7 для интерфейсов, VLAN, DHCP, DNS, файрвола, NAT, маршрутов и бэкапов, парк роутеров через инвентарь, режим только чтения.

Как подключить

Что сделать до подключения

Python 3.10 или новее и uv с командой uvx

Роутер MikroTik с RouterOS, доступный по SSH; проверялся на RouterOS 7

MIKROTIK_HOST

IP-адрес или имя роутера, по умолчанию 192.168.88.1

MIKROTIK_USERNAME

пользователь SSH на роутере; лучше отдельный с минимальными правами

MIKROTIK_PASSWORD

пароль этого пользователя; вместо него можно указать ключ флагом --key-filename

MIKROTIK_READ_ONLY

необязательно: true — оставить только инструменты, которые ничего не меняют

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MIKROTIK_HOST=<IP роутера>' --env 'MIKROTIK_USERNAME=<пользователь SSH>' --env 'MIKROTIK_PASSWORD=<пароль SSH>' --transport stdio mikrotik \
  -- uvx mcp-server-mikrotik

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mikrotik]
command = "uvx"
args = ["mcp-server-mikrotik"]

[mcp_servers.mikrotik.env]
MIKROTIK_HOST = "<IP роутера>"
MIKROTIK_USERNAME = "<пользователь SSH>"
MIKROTIK_PASSWORD = "<пароль SSH>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mikrotik": {
      "command": "uvx",
      "args": ["mcp-server-mikrotik"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_PASSWORD": "<пароль SSH>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mikrotik": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-mikrotik"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_PASSWORD": "<пароль SSH>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mikrotik": {
      "command": "uvx",
      "args": ["mcp-server-mikrotik"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_PASSWORD": "<пароль SSH>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mikrotik": {
      "command": "uvx",
      "args": ["mcp-server-mikrotik"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_PASSWORD": "<пароль SSH>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mikrotik": {
        "type": "local",
        "command": ["uvx", "mcp-server-mikrotik"],
        "environment": {
          "MIKROTIK_HOST": "<IP роутера>",
          "MIKROTIK_USERNAME": "<пользователь SSH>",
          "MIKROTIK_PASSWORD": "<пароль SSH>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "mikrotik": {
      "command": "uvx",
      "args": ["mcp-server-mikrotik"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_PASSWORD": "<пароль SSH>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mikrotik": {
      "command": "uvx",
      "args": ["mcp-server-mikrotik"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_PASSWORD": "<пароль SSH>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_devicesвыводит роутеры из инвентаря

get_system_resourceчитает загрузку процессора и памяти

list_interfacesвыводит интерфейсы

create_vlan_interfaceсоздаёт VLAN

add_ip_addressдобавляет IP-адрес

create_dhcp_serverподнимает DHCP-сервер

list_dhcp_leasesвыводит аренды DHCP

add_dns_staticдобавляет статическую DNS-запись

list_filter_rulesвыводит правила файрвола

create_filter_ruleдобавляет правило файрвола

create_basic_firewall_setupставит пять базовых правил защиты

create_nat_ruleдобавляет правило NAT

list_routesвыводит маршруты

add_wireguard_peerдобавляет пира WireGuard

generate_wireguard_client_configсобирает конфиг клиента WireGuard

create_backupсохраняет бэкап

create_exportвыгружает конфигурацию

get_logsчитает журнал

enable_safe_modeвключает Safe Mode

rollback_safe_modeоткатывает изменения Safe Mode

Сервер на Bun с 983 инструментами в 155 модулях, транзакциями и Safe Mode, несколькими роутерами и веб-панелью на 127.0.0.1:9090 для диагностики и контролируемых изменений.

Как подключить

Что сделать до подключения

Bun 1.4.4 или новее и пакет: bun add -g @usex/mikrotik-mcp

SSH на роутере включён в /ip service; открытый ключ импортирован пользователю в System → Users → SSH Keys

Проверить связь командой mikrotik-mcp auth-check до подключения клиента

MIKROTIK_HOST

IP-адрес роутера

MIKROTIK_USERNAME

пользователь RouterOS для агента

MIKROTIK_KEY_FILENAME

путь к закрытому ключу SSH; вместо ключа можно задать MIKROTIK_PASSWORD

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MIKROTIK_HOST=<IP роутера>' --env 'MIKROTIK_USERNAME=<пользователь SSH>' --env 'MIKROTIK_KEY_FILENAME=<абсолютный путь к закрытому ключу>' --transport stdio mikrotik-mcp \
  -- mikrotik-mcp serve

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mikrotik-mcp]
command = "mikrotik-mcp"
args = ["serve"]

[mcp_servers.mikrotik-mcp.env]
MIKROTIK_HOST = "<IP роутера>"
MIKROTIK_USERNAME = "<пользователь SSH>"
MIKROTIK_KEY_FILENAME = "<абсолютный путь к закрытому ключу>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mikrotik-mcp": {
      "command": "mikrotik-mcp",
      "args": ["serve"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mikrotik-mcp": {
      "type": "stdio",
      "command": "mikrotik-mcp",
      "args": ["serve"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mikrotik-mcp": {
      "command": "mikrotik-mcp",
      "args": ["serve"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mikrotik-mcp": {
      "command": "mikrotik-mcp",
      "args": ["serve"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mikrotik-mcp": {
        "type": "local",
        "command": ["mikrotik-mcp", "serve"],
        "environment": {
          "MIKROTIK_HOST": "<IP роутера>",
          "MIKROTIK_USERNAME": "<пользователь SSH>",
          "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mikrotik-mcp": {
      "command": "mikrotik-mcp",
      "args": ["serve"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mikrotik-mcp": {
      "command": "mikrotik-mcp",
      "args": ["serve"],
      "env": {
        "MIKROTIK_HOST": "<IP роутера>",
        "MIKROTIK_USERNAME": "<пользователь SSH>",
        "MIKROTIK_KEY_FILENAME": "<абсолютный путь к закрытому ключу>"
      }
    }
  }
}

Инструменты сервера

list_filter_rulesвыводит правила файрвола

create_filter_ruleдобавляет правило файрвола

update_filter_ruleменяет правило

move_filter_ruleпереставляет правило

disable_filter_ruleотключает правило

create_basic_firewall_setupставит базовую защиту

enable_safe_modeоткрывает сессию Safe Mode

safe_mode_statusпоказывает состояние Safe Mode

commit_safe_modeприменяет изменения

rollback_safe_modeоткатывает изменения

Показано 10 из 983.

Один инструмент mikrotik_terminal: агент шлёт любую команду RouterOS вида /ip/service/print через RouterOS API, без готового набора операций.

Как подключить

Что сделать до подключения

uv; склонировать репозиторий и выполнить uv sync

Роутер с включённым RouterOS API

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-mikrotik \
  -- uv --directory /path/to/mcp-mikrotik run python server.py

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-mikrotik]
command = "uv"
args = ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-mikrotik": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-mikrotik": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-mikrotik": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-mikrotik": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-mikrotik": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "/path/to/mcp-mikrotik",
          "run",
          "python",
          "server.py"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-mikrotik": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-mikrotik": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-mikrotik", "run", "python", "server.py"]
    }
  }
}

Инструменты сервера

mikrotik_terminalвыполняет команду RouterOS

Что попросить агента

«Покажи загрузку процессора и память роутера»wiresage вызовет get_system_resource

«Заведи VLAN 20 на ether2 с адресом 10.0.20.1/24 и DHCP для этой сети»Агент вызовет create_vlan_interface, add_ip_address и create_dhcp_server

«Сделай бэкап, потом в Safe Mode добавь правило, которое режет вход на роутер из интернета»Агент вызовет create_backup, enable_safe_mode и create_filter_rule, после проверки — commit_safe_mode

«Добавь пира WireGuard для ноутбука и дай мне конфиг»Агент вызовет add_wireguard_peer и generate_wireguard_client_config

«Отключи telnet на роутере 192.168.10.1»algonacci/mcp-mikrotik вызовет mikrotik_terminal с командой /ip/service/set [find name=telnet] disabled=yes

Для каких задач

Посмотреть интерфейсы, адреса, маршруты и аренды DHCP

Завести VLAN с адресом и DHCP-сервером для новой сети

Добавить правило файрвола или NAT и поставить базовую защиту

Добавить пира WireGuard и собрать конфиг для клиента

Сделать бэкап и выгрузить конфигурацию перед изменениями

Внести рискованные правки в Safe Mode и откатить их при ошибке

Ограничения

Флаг --read-only у wiresage только убирает инструменты записи из списка: настоящую защиту даёт учётная запись RouterOS с урезанными правами

wiresage не трогает перезагрузку, сброс и выключение, а также BGP, OSPF, контейнеры и хотспот

mikrotik-mcp/mikrotik-mcp — молодой проект с 26 звёздами; Safe Mode и откат на нескольких устройствах имеют практические пределы и не заменяют проверку

У algonacci/mcp-mikrotik 5 звёзд и обновление в мае 2026 года; логин и пароль роутера агент передаёт в каждом вызове, команды выполняются сразу

Если не работает

mikrotik-mcp auth-check пишет Connection FAILED.

Проверьте адрес роутера, логин и пароль или ключ, порт SSH и то, что роутер доступен по сети.

После импорта ключа пропал вход по паролю

Импорт ключа SSH может отключить пароль для этого пользователя: держите открытой текущую сессию управления, пока Test connection не пройдёт.

За обратным прокси запросы к /mcp получают 421 Invalid Host header

Добавьте домен, по которому клиенты ходят к серверу wiresage, в MIKROTIK_MCP__ALLOWED_HOSTS.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MikroTik MCP	wiresage (Jeff Nasseri и соавторы)	334	локально	токен	20	10 ноября 2026
MikroTik MCP (Bun)	Ali Torki (ali-master)	26	локально	токен	983	11 ноября 2026
mcp-mikrotik	algonacci	5	локально	не нужен	1	24 мая 2026

Частые вопросы

Какой сервер MikroTik выбрать?

Для повседневной настройки одного или нескольких роутеров подойдёт wiresage/mikrotik-mcp из PyPI. Если нужны транзакции, веб-панель и сотни специальных инструментов, смотрите сервер на Bun. algonacci/mcp-mikrotik годится для разовых команд RouterOS.

Как не дать агенту сломать роутер?

Заведите агенту отдельного пользователя RouterOS с нужными правами, по возможности только для чтения, и включите MIKROTIK_READ_ONLY=true. Изменения вносите в Safe Mode: при откате сервер закрывает сессию, и RouterOS сам возвращает прежнюю конфигурацию.

Можно управлять несколькими роутерами?

Да. У wiresage с версии 0.14.0 есть инвентарь: список устройств в YAML через MIKROTIK_INVENTORY или файл MIKROTIK_INVENTORY_FILE. У сервера на Bun роутер выбирается необязательным аргументом device.

Агент увидит пароли и ключи из конфигурации?

С флагом --sensitive-hiding сервер wiresage вырезает пароли, ключи, токены и SNMP-community из ответов и логов. Открытые ключи, адреса и SSID остаются видны.

Как подключить MikroTik MCP к Claude Code?

Выполните claude mcp add io.github.wiresage/mikrotik-mcp: клиент возьмёт сервер из MCP Registry, поставит mcp-server-mikrotik из PyPI и спросит MIKROTIK_HOST, MIKROTIK_USERNAME и MIKROTIK_PASSWORD. Ручной конфиг есть во вкладке Claude Code.

Где скачать MikroTik MCP?

Сервер wiresage опубликован в PyPI как mcp-server-mikrotik и в виде образа ghcr.io/wiresage/mikrotik-mcp для amd64 и arm64. Сервер на Bun ставится командой bun add -g @usex/mikrotik-mcp.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и ходят к роутеру по SSH или RouterOS API внутри вашей сети, внешние сервисы им не нужны.

MikroTik MCP: настройка роутера агентом в Claude, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы