NetBox MCP Server
Read-only сервер для взаимодействия с данными NetBox через языковые модели
Описание
Это простой read-only сервер на основе Model Context Protocol для NetBox, позволяющий LLMs запрашивать данные напрямую. Поддерживает инструменты для получения объектов, детальной информации по ID и истории изменений. Ограничен core-объектами NetBox (без плагинов). Идеален для анализа сетевой инфраструктуры: запросы о устройствах, IPAM, изменениях. Технологии: Python, API NetBox. Применения: мониторинг сетей, аудит через чат-боты.
Возможности
get_objects
Получение core-объектов NetBox по типу и фильтрам (устройства, сайты и т.д.)
get_object_by_id
Детальная информация о конкретном объекте NetBox по его ID
get_changelogs
Извлечение записей истории изменений (audit trail) с фильтрами по времени и объектам
Установка
Создайте read-only API-токен в NetBox с нужными правами.
Установите зависимости:
# Рекомендуется UV
uv sync
# Или pip
pip install -e .
Проверьте запуск:
NETBOX_URL=https://netbox.example.com/ NETBOX_TOKEN=<ваш-токен> uv run server.pyДобавьте конфигурацию в клиент LLM (пример для Claude Desktop):
{
"mcpServers": {
"netbox": {
"command": "uv",
"args": [
"--directory",
"/path/to/netbox-mcp-server",
"run",
"server.py"
],
"env": {
"NETBOX_URL": "https://netbox.example.com/",
"NETBOX_TOKEN": "<ваш-api-токен>"
}
}
}
}
На Windows используйте полные пути. Подробности: MCP quickstart.