NetBox MCP Server
NetBox MCP возвращает выбранные поля инвентаризации: агент получает краткую выборку устройств и адресов без доступа к записи.
- 254 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент получает сведения о сетевых устройствах, адресах и журнале изменений в пределах токена NetBox.
Установка
- Работает в
Ручная установка
uv syncПервый рекомендуемый способ установки зависимостей из локального репозитория. Затем настройте URL, токен и подключение клиента.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент получает сведения о сетевых устройствах, адресах и журнале изменений в пределах токена NetBox.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
NetBox MCP Server подключает агента к объектам сетевого учета из NetBox. Можно искать устройства и адреса по фильтрам, открывать подробности объекта и просматривать историю изменений. Запись в NetBox не входит в этот сервер. Для уменьшения ответа пользователь выбирает нужные поля. Объекты плагинов могут добавляться через отдельное обнаружение, если NetBox и права токена это поддерживают. В ответах используется сохраненная инвентаризация. Доступность оборудования администратор проверяет отдельным сетевым инструментом.
Для кого. Сетевым администраторам NetBox, которым нужно находить устройства, адреса и изменения учета через агента без записи.
Подходит, если
- Администратор выбирает устройства площадки и их основные адреса.
- При разборе объекта команда смотрит, кто и когда изменил сведения в NetBox.
- Использование адресного пространства изучают по сохраненным данным IPAM.
- Из большого объекта агент запрашивает только поля, нужные для ответа.
Не подходит, если
- Требуется создавать или изменять объекты NetBox через этот сервер.
- Нужно проверить доступность оборудования активным сетевым опросом.
- Для задачи необходимы GraphQL и расширение серверного кода плагинами.
Пример запроса к агенту
Покажи устройства площадки DC14 с именем, статусом и основным IP, затем последние изменения одного выбранного объекта.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
NETBOX_URLобязательная- Адрес вашей установки NetBox.
NETBOX_TOKENобязательная, секрет- Токен NetBox только для чтения.
MCP_AUTH_TOKENсекрет- Отдельный Bearer-токен защиты HTTP-подключения.
Ограничения
Нужны URL NetBox и токен с доступом к требуемым объектам, желательно отдельная роль чтения. HTTP-подключение без MCP_AUTH_TOKEN не имеет аутентификации, поэтому не открывайте его сети без защиты и TLS. Обнаружение объектов плагинов выключено по умолчанию и требует NetBox 4.2 или новее с доступом к списку типов. При ошибке обнаружения сервер продолжает работать только с основными объектами и сообщает предупреждение.
Как отключить. Отключите MCP-клиент, остановите сервер и отзовите выделенный NetBox-токен. Саму инвентаризацию удалять не требуется.
Частые вопросы
Можно ли менять данные?
Нет. Сервер ориентирован на чтение. Для записи нужен другой согласованный инструмент.
Как сократить ответ?
Укажите `fields` с нужными полями. Проверьте, что оставшихся данных достаточно для вывода.
Почему не виден объект плагина?
Задайте `ENABLE_PLUGIN_DISCOVERY=true` или `--enable-plugin-discovery` и перезапустите сервер. Нужны NetBox 4.2 или новее и права на список типов; если обнаружение завершится ошибкой, останутся основные объекты.
Что изменилось после старой версии?
Запуск `server.py` заменен на `netbox-mcp-server`. Обновите конфигурацию клиента при переходе.
Как проверить подключение Claude Code?
Откройте `/mcp` или выполните `claude mcp list`. После этого сделайте небольшой запрос чтения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыZabbix MCP Server (mpeirone)
Zabbix MCP Server
MCP-сервер открывает агенту методы Zabbix API через вызов, справку и поиск методов с настройками чтения и разрешенных операций.
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
MCP-сервер подключает агента к сети UniFi для диагностики устройств, проверки настроек и согласованных изменений
Zabbix MCP Server
zabbix-mcp-server
MCP-сервер для всего API Zabbix: 237 инструментов, несколько серверов Zabbix, токены с областями и режим только чтения
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
Официальный MCP-сервер Cloudflare: агент управляет всем API Cloudflare через поиск по спецификации и выполнение кода
Коротко о README
Конфигурация допускает окружение, env-файл и аргументы командной строки. Для развертывания есть готовые Docker-образы с проверяемым происхождением.