Перейти к содержимому

NetBox MCP Server

Read-only сервер для взаимодействия с данными NetBox через языковые модели

Python
62 stars

Описание

Это простой 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) с фильтрами по времени и объектам

Установка

  1. Создайте read-only API-токен в NetBox с нужными правами.

  2. Установите зависимости:

# Рекомендуется UV
uv sync

# Или pip
pip install -e .
  1. Проверьте запуск: NETBOX_URL=https://netbox.example.com/ NETBOX_TOKEN=<ваш-токен> uv run server.py

  2. Добавьте конфигурацию в клиент 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.

Информация

Язык
Python
Лицензия
Apache License 2.0
GitHub Stars
62

Ссылки