📡 UniFi Network MCP Server
Предоставляет инструменты для управления UniFi-сетью через MCP: фаервол, VPN, устройства, клиенты и статистика.
Описание
Это self-hosted MCP-сервер для UniFi Network Controller, интегрирующийся с LLM и агентами (Claude Desktop, LM Studio). Ключевые особенности: полный доступ к API UniFi (фаервол, роуты, порты, QoS, VPN, WLAN, устройства, клиенты, статистика). Мутации требуют confirm=true для безопасности. Технологии: Python 3.10+, FastMCP по stdio, опциональный HTTP SSE. Применения: анализ и автоматизация сети локально или в облаке с прокси, с учетом security (read-only по умолчанию).
Возможности
Управление фаерволом
Просмотр, создание, обновление, переключение политик фаервола и зон.
Трафик-роуты
Список, детализация, создание, обновление и переключение маршрутов трафика.
Порт-форвардинг
Управление портами: список, создание, обновление, переключение.
QoS и трафик-шейпинг
Правила QoS: список, создание, обновление, переключение.
Сети и WLAN
Управление сетями и Wi-Fi: список, детали, создание, обновление.
VPN
Клиенты и серверы VPN: список, детали, обновление состояния.
Устройства
Список устройств, детали, перезагрузка, переименование, адопт, апгрейд.
Клиенты
Список клиентов, детали, блокировка, переименование, принудительное подключение.
Статистика и алерты
Сетевая статистика, топ-клиенты, DPI, алерты, здоровье сети.
Установка
Установка через Docker:
docker pull ghcr.io/sirkirby/unifi-network-mcp:latest
docker run -i --rm -e UNIFI_HOST=192.168.1.1 -e UNIFI_USERNAME=admin -e UNIFI_PASSWORD=secret -e UNIFI_PORT=443 -e UNIFI_SITE=default -e UNIFI_VERIFY_SSL=false ghcr.io/sirkirby/unifi-network-mcp:latest
Через Python/UV:
curl -fsSL https://astral.sh/uv/install.sh | bash
git clone https://github.com/sirkirby/unifi-network-mcp.git
cd unifi-network-mcp
uv venv
source .venv/bin/activate
uv pip install --no-deps -e .
cp .env.example .env # отредактировать
unifi-network-mcp
Из PyPI: uv pip install unifi-network-mcp (доступно после публикации).