MCP-сервер для Icinga

mcp-server-icinga — это сервер протокола контекста модели (MCP), который позволяет ИИ-клиентам, таким как Claude, работать с инсталляциями Icinga с помощью естественного языка. Он предназначен для системных инженеров Linux, которые используют Icinga в продакшене и хотят иметь чат-интерфейс для ежедневной сортировки, расследования инцидентов и рутинных операций поверх существующих REST API Icinga.

Этот проект был разработан с помощью Claude Code от Anthropic.

Область применения

Сервер связывает три интерфейса Icinga и стек мониторинга Linuxfabrik:

• Icinga 2 Core REST API (порт 5665): живые объекты хостов и сервисов, проверки по требованию, подтверждения, периоды обслуживания.

• Icinga Web 2 / модуль Icinga DB Web: более богатые проекции состояний, история, комментарии, уведомления, с учетом ограничений интерфейса Icinga Web.

• Icinga Director API: просмотр объектов, интроспекция шаблонов сервисов, каталог команд.

• Каталог monitoring-plugins от Linuxfabrik: реализация, входные и выходные данные, состояния и данные о производительности каждого плагина проверки, чтобы сервер мог объяснить, почему сервис выдает оповещение, а не просто констатировать факт.

• База данных временных рядов (по умолчанию: InfluxDB, модульная): исторические данные о производительности для анализа трендов, анализа «флэппинга» (нестабильности) и расследования первопричин.

Каждый бэкенд находится в своем собственном модуле, поэтому операторы могут подключать только то, что они действительно используют. Сервер прозрачно помечает информацию, которую базовый API не предоставляет, вместо того чтобы пытаться угадать.

Related MCP server: PilotOps MCP

Статус

Ранняя стадия разработки. Архитектура, конфигурация и набор инструментов нестабильны и будут меняться.

Требования

• Python 3.14 или новее.

• Доступная инсталляция Icinga (одна или несколько из: Icinga 2 Core API, Icinga Web 2 с модулем Icinga DB Web, Icinga Director).

• Опционально: бэкенд базы данных временных рядов для исторических данных о производительности. Интеграция по умолчанию — InfluxDB; уровень TSDB модульный, поэтому можно подключить другие бэкенды.

Установка

Инструкции по установке будут задокументированы после выпуска первой версии.

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

Документация по конфигурации появится, как только стабилизируется конфигурационный интерфейс.

Связанные проекты

• Linuxfabrik monitoring-plugins: каталог плагинов проверки, который понимает этот сервер.

• Linuxfabrik lib: общие вспомогательные библиотеки Python.

• Icinga/icinga-mcp: экспериментальный MCP-сервер от команды Icinga. Другая область применения, другая архитектура.

Лицензия

Выпущено в общественное достояние под лицензией Unlicense.