alertmanager-mcp-server

Apache 2.0
  • Linux
  • Apple

Integrations

  • Supports containerized deployment of the MCP server through Docker, with configuration via environment variables for connecting to Alertmanager instances.

  • Enables querying and managing Prometheus Alertmanager resources including status, alerts, silences, receivers, and alert groups. Supports creating new alerts, managing silences (create, update, delete), and retrieving alert information through the Alertmanager API v2.

Оглавление

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 Локальный запуск

  • Клонируйте репозиторий:
# 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" } } } }

3.3. Запуск 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 $ uv venv $ source .venv/bin/activate # On Unix/macOS $ .venv\Scripts\activate # On Windows $ uv pip install -e . # run test $ pytest

6. Лицензия

Апач 2.0


You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

alertmanager-mcp-сервер

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

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A simple MCP server that can send notifications on mac devices.
              Last updated -
              5
              9
              8
              TypeScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              The MCP server that keeps you informed by sending the notification on phone using ntfy.sh
              Last updated -
              18
              6
              JavaScript
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            ID: oblhy82ylg