Wazuh MCP Server

Установка

Работает в

• Claude Desktop
• SourceCraft
• Koda
• Coddy

Ручная установка

git clone https://github.com/gensecaihq/Wazuh-MCP-Server.git
cd Wazuh-MCP-Server
cp .env.example .env

Что делает

Wazuh MCP Server дает MCP-клиенту доступ к вашей системе Wazuh через 55 инструментов в восьми наборах: оповещения, агенты, уязвимости, анализ угроз, соответствие стандартам, состояние менеджера и кластера, внешний контекст и активное реагирование. Сервер работает по Streamable HTTP по адресу `/mcp`. Он выполняет инструменты, но собственной модели не вызывает. 41 инструмент только читает: сводки и поиск по оповещениям, процессы и порты агентов, критичные уязвимости, проверки PCI-DSS, HIPAA, SOX, GDPR, NIST и ISO 27001, статистика кластера. Остальные 14 меняют состояние: блокировка IP, изоляция хоста, остановка процесса, отключение пользователя, карантин файла и обратные операции. Для них нужна область доступа `wazuh:write`, которая по умолчанию не выдается. В рабочем режиме запись требует флага `confirm=true`; его передает сам клиент. У сервера есть пять готовых промптов для расследования, охоты на угрозы, аудита соответствия, оценки уязвимостей и проверки по ISO 27001. Он запускается через Docker Compose или готовый образ, умеет работать с несколькими кластерами и с локальной моделью через vLLM и Open WebUI.

Для кого. Для инженеров SOC и администраторов Wazuh, которые хотят разбирать оповещения и уязвимости через Claude или локальную модель и сохранять контроль над действиями реагирования.

Пример запроса к агенту

Покажи оповещения высокого уровня за сутки, сгруппируй по агентам и для самых частых IP проверь репутацию, но ничего не блокируй

MCP

Транспорт

http

Авторизация

API-ключ

Ограничения

Для запуска требуются Docker с Compose v2 и пользователь API менеджера Wazuh. Сервер слушает обычный HTTP, поэтому перед внешним доступом поставьте обратный прокси с TLS. Для Claude в виде пользовательского коннектора нужен публичный адрес HTTPS.

Сертификат менеджера по умолчанию проверяется. У свежей установки Wazuh сертификат самоподписанный, и для первой пробы можно включить `WAZUH_ALLOW_SELF_SIGNED=true`, но тогда проверка отключается. Ответ активного реагирования подтверждает только доставку команды агенту Wazuh. Выполнение проверяйте инструментами `wazuh_check_*`. Блокировки действуют, пока их не снимут: срок им задать нельзя, сервер отклоняет положительное значение. При обновлении с версии 4.x сначала прочтите `UPGRADING.md`. Код распространяется по лицензии MIT. Начните с токена только для чтения.

Как отключить. Выполните `docker compose down` в папке сервера и удалите коннектор из клиента. Чтобы оставить только чтение, держите в `MCP_API_KEY_SCOPES` одну область `wazuh:read` и скройте опасные инструменты через `WAZUH_DISABLED_TOOLS`.

Коротко о README

Репозиторий содержит сервер на Python 3.11 и новее на FastAPI, образы для amd64 и arm64 и набор документов: настройка, интеграция с Claude, локальные модели, несколько кластеров, эксплуатация, защита. В нем есть проверка выбора инструментов `evals/tool_selection.py` на 25 сценариях SOC, включая две попытки инъекции промпта.