alertmanager-mcp-server

Оглавление

• Оглавление
• 1. Введение
• 2. Особенности
• 3. Быстрый старт
  • 3.1 Предпосылки
  • 3.2 Установка через Smithery
  • 3.3 Локальный запуск
  • 3.4. Запуск Docker
• 4. Инструменты
• 5. Развитие
• 6. Лицензия

1. Введение

Prometheus Alertmanager MCP — это сервер Model Context Protocol (MCP) для Prometheus Alertmanager. Он позволяет помощникам и инструментам ИИ запрашивать и управлять ресурсами Alertmanager программно и безопасно.

2. Особенности

• [x] Запрос статуса Alertmanager, оповещений, тишины, приемников и групп оповещений
• [x] Создание, обновление и удаление тишины
• [x] Создать новые оповещения
• [x] Поддержка аутентификации (базовая аутентификация через переменные среды)
• [x] Поддержка контейнеризации Docker

3. Быстрый старт

3.1 Предпосылки

• Питон 3.12+
• uv (для быстрого управления зависимостями).
• Docker (опционально, для контейнерного развертывания).
• Убедитесь, что ваш сервер Prometheus Alertmanager доступен из среды, в которой вы будете запускать этот сервер MCP.

3.2 Установка через Smithery

Чтобы автоматически установить Prometheus Alertmanager MCP Server для Claude Desktop через Smithery :

3.3 Локальный запуск

• Клонируйте репозиторий:

• Настройте переменные среды для вашего сервера Prometheus с помощью файла .env или системных переменных среды:

• Добавьте конфигурацию сервера в файл конфигурации клиента. Например, для Claude Desktop:

• Или установите его с помощью команды make:

• Перезапустите Claude Desktop, чтобы загрузить новую конфигурацию.
• Теперь вы можете попросить Клода взаимодействовать с Alertmanager, используя естественный язык:
  • «Покажи мне текущие оповещения»
  • «Фильтрация оповещений, связанных с проблемами ЦП»
  • «Получить подробности по этому оповещению»
  • «Создать тишину для этого оповещения на следующие 2 часа»

3.4. Запуск Docker

• Запустите его с помощью готового образа (или вы можете собрать его самостоятельно):

• Запуск с Docker в Claude Desktop:

Эта конфигурация передает переменные среды из Claude Desktop в контейнер Docker, используя флаг -e только с именем переменной и предоставляя фактические значения в объекте env .

4. Инструменты

Сервер MCP предоставляет инструменты для запросов и управления Alertmanager, следуя его API v2 :

• Получить статус: get_status()
• Список оповещений: get_alerts()
• Список тишины: get_silences()
• Создать тишину: post_silence(silence_dict)
• Удалить тишину: delete_silence(silence_id)
• Список приемников: get_receivers()
• Список групп оповещений: get_alert_groups()

Полную информацию об API см. в src/alertmanager_mcp_server/server.py .

5. Развитие

Вклады приветствуются! Пожалуйста, откройте тему или отправьте запрос на извлечение, если у вас есть какие-либо предложения или улучшения.

Этот проект использует uv для управления зависимостями. Установите uv, следуя инструкциям для вашей платформы.

6. Лицензия

Апач 2.0