Name: alertmanager-mcp-server
Author: ntk148v

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 :

npx -y @smithery/cli install @ntk148v/alertmanager-mcp-server --client claude

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

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

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git

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

# Set environment variables (see .env.sample) ALERTMANAGER_URL=http://your-alertmanager:9093 ALERTMANAGER_USERNAME=your_username # optional ALERTMANAGER_PASSWORD=your_password # optional

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

{ "mcpServers": { "alertmanager": { "command": "uv", "args": [ "--directory", "<full path to alertmanager-mcp-server directory>", "run", "src/alertmanager_mcp_server/server.py" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

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

$ make install

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

3.4. Запуск Docker

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

$ docker run -e ALERTMANAGER_URL=http://your-alertmanager:9093 \ -e ALERTMANAGER_USERNAME=your_username \ -e ALERTMANAGER_PASSWORD=your_password \ -p 8000:8000 ghcr.io/ntk148v/alertmanager-mcp-server

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

{ "mcpServers": { "alertmanager": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "ALERTMANAGER_URL", "-e", "ALERTMANAGER_USERNAME", "-e", "ALERTMANAGER_PASSWORD", "ghcr.io/ntk148v/alertmanager-mcp-server:latest" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

Эта конфигурация передает переменные среды из 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, следуя инструкциям для вашей платформы.

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git $ cd alertmanager-mcp-server $ make setup # Run test $ make test # Run in development mode $ mcp dev $ TRANSPORT_MODE=sse mcp dev # Install in Claude Desktop $ make install