defined-mcp

MCP-сервер для API Defined Networking.

Установка

uv tool install git+https://github.com/quickvm/defined-mcp.git

Чтобы установить определенную версию или ветку:

uv tool install git+https://github.com/quickvm/defined-mcp.git@main

Для локальной разработки:

git clone git@github.com:quickvm/defined-mcp.git
cd defined-mcp
uv tool install --editable .

Related MCP server: UniFi MCP Server

Конфигурация

Установите переменную окружения DEFINED_API_KEY для вашего ключа API Defined Networking. Получите его в своей панели администратора.

export DEFINED_API_KEY=dnkey-...

Использование

Добавление в Claude Code

claude mcp add defined_mcp -- defined-mcp serve

Затем перезапустите Claude Code.

Проверка подключения

defined-mcp check

Запуск в автономном режиме

defined-mcp serve

Доступные инструменты

Хосты

• list_hosts — список хостов с фильтрами (роль, заблокирован, маяк, ретранслятор)

• get_host — получение сведений о хосте

• create_host — создание хоста/маяка/ретранслятора

• update_host — обновление хоста (полная замена)

• delete_host — удаление хоста

• block_host / unblock_host — блокировка/разблокировка хоста

• add_host_tag / remove_host_tag — добавление/удаление тега у хоста

• create_enrollment_code — генерация кода регистрации

• create_host_and_enrollment_code — создание хоста + кода регистрации

Роли и правила брандмауэра

• list_roles / get_role — список/получение ролей с правилами брандмауэра

• create_role / update_role — создание/обновление ролей (полная замена)

• delete_role — удаление роли

• add_firewall_rule — добавление правила брандмауэра к роли (плоские параметры, без JSON)

• remove_firewall_rule — удаление правила брандмауэра по индексу

Теги

• list_tags / get_tag — список/получение тегов

• create_tag / update_tag — создание/обновление тегов с переопределением конфигурации

• delete_tag — удаление тега

• add_tag_config_override — добавление/замена переопределения конфигурации для тега

• remove_tag_config_override — удаление переопределения конфигурации по ключу

Сети

• list_networks / get_network — список/получение сетей

• create_network / update_network — создание/обновление сетей

Маршруты

• list_routes / get_route — список/получение маршрутов с правилами брандмауэра

• create_route / update_route — создание/обновление маршрутов (полная замена)

• delete_route — удаление маршрута

• add_route_firewall_rule — добавление правила брандмауэра к маршруту

• remove_route_firewall_rule — удаление правила брандмауэра маршрута по индексу

Прочее

• list_audit_logs — журнал аудита с фильтрами

• list_downloads — ссылки на скачивание ПО (без аутентификации)

Навыки Claude Code

Этот репозиторий включает навык Claude Code для интерактивного управления сетью. Когда вы запускаете Claude Code из этого репозитория, команда /network-architect становится доступной автоматически.

Чтобы использовать этот навык в любом проекте, скопируйте его в свой профиль Claude Code:

cp -r .claude/skills/network-architect ~/.claude/skills/

/network-architect audit

Выполняет аудит безопасности и конфигурации вашей учетной записи Defined Networking. Извлекает все сети, роли, теги и хосты, а затем сообщает о:

• Ролях с отсутствующими или слишком разрешительными правилами брандмауэра

• Неактивных тегах (назначено ноль хостов)

• Хостах без тегов, устаревших версиях dnclient или устаревших данных о последнем посещении

• Сводке покрытия брандмауэра по ролям с деталями портов/протоколов/тегов

/network-architect design

Интерактивная сессия проектирования политики брандмауэра. Задает вопросы о ваших сервисах, требованиях к доступу и потребностях в сегментации, а затем предлагает:

• Структуру ролей (чем ЯВЛЯЕТСЯ каждый тип хоста)

• Таксономию тегов (теги доступа, такие как ssh:allow, теги идентификации, такие как user-type:admin)

• Правила брандмауэра для каждой роли в табличном формате с логикой AND (роль + теги)

/network-architect apply

Реализует дизайн сети с использованием атомарных инструментов (add_firewall_rule, add_host_tag и т. д.). Сначала считывает текущее состояние, показывает различия (diff), запрашивает подтверждение, а затем проверяет результат после применения.

Лицензия

MIT