Suzieq — MCP-сервер для Claude Code: запросы к сети через REST API
MCP-сервер для взаимодействия с SuzieQ — платформой мониторинга сетей. Позволяет Claude и другим ИИ-инструментам отправлять команды show и summarize к запущенному экземпляру SuzieQ через его REST API.
лицензия не указана обновлён 2026-10-29
Открыть на GitHubЧто делает Suzieq
Сервер предоставляет два инструмента: run_suzieq_show для запроса таблиц состояния сети (интерфейсы, BGP, маршруты, устройства) с фильтрацией, и run_suzieq_summarize для получения агрегированной статистики. Результаты приходят JSON-строкой прямо из вашего экземпляра SuzieQ.
Для работы нужны Python 3.8+, установленный uv, запущенный экземпляр SuzieQ с включённым REST API, URL API (например, http://your-suzieq-host:8000/api/v2) и API-ключ. Сервер загружает конфигурацию из файла .env в директории проекта — туда кладёшь SUZIEQ_API_ENDPOINT и SUZIEQ_API_KEY.
Установка через Smithery одной командой, или вручную: клонируешь репозиторий, создаёшь виртуальное окружение (uv venv), активируешь его, устанавливаешь зависимости (uv pip install mcp httpx python-dotenv), добавляешь .env с учётными данными, потом регистрируешь сервер в claude_desktop_config.json с абсолютным путём к main.py и workingDirectory.
Какие задачи решает
- запросить интерфейсы по фильтру хоста или VRF
- получить сводку BGP-соседей для устройства
- найти маршруты в сети с условиями
- собрать данные об устройствах и их состоянии
- проанализировать таблицы состояния сети через ИИ
Примеры запросов агенту
- Покажи все устройства в сети через таблицу device
- Какие BGP-соседи у spine01? Используй таблицу bgp и фильтр hostname:spine01
- Выведи поднятые интерфейсы в VRF default с фильтрацией state:up и vrf:default
Как установить Suzieq
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Suzieq
Как установить Suzieq MCP-сервер?
Способ 1 через Smithery: npx -y @smithery/cli install @PovedaAqui/suzieq-mcp --client claude. Способ 2 вручную: клонируешь репозиторий, выполняешь uv venv, активируешь окружение (source .venv/bin/activate на macOS/Linux или .venv\Scripts\activate на Windows), запускаешь uv pip install mcp httpx python-dotenv, создаёшь .env с SUZIEQ_API_ENDPOINT и SUZIEQ_API_KEY, добавляешь сервер в claude_desktop_config.json с абсолютным путём к main.py.
Что делает Suzieq MCP-сервер?
Сервер подключает Claude и другие ИИ-инструменты к SuzieQ — платформе мониторинга сетей. Через два инструмента (run_suzieq_show и run_suzieq_summarize) ИИ может запрашивать таблицы состояния сети, применять фильтры и получать результаты для анализа.
Какие требования для запуска?
Python 3.8 или выше, инструмент uv для управления пакетами, запущенный экземпляр SuzieQ с включённым REST API, URL API и действительный API-ключ. Сервер будет искать их в файле .env в директории проекта.