Prometheus MCP Server

Prometheus MCP Server — MCP-сервер сообщества (автор — pab1it0). Метрики Prometheus и запросы PromQL. Ставится через Docker. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
pab1it0
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
python

Уровень риска: medium

Только чтение метрик Prometheus; метрики раскрывают структуру инфраструктуры; учётные данные — через переменные окружения.

Настройка клиентов

claude-code
{
    "code": "claude mcp add prometheus --env PROMETHEUS_URL=http://your-prometheus:9090 -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server:latest",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Prometheus MCP Server даёт ИИ-ассистентам доступ к метрикам Prometheus: выполнение запросов PromQL и анализ данных мониторинга через стандартный интерфейс MCP.

Инструменты:

  • execute_query — мгновенный запрос PromQL;
  • execute_range_query — запрос за интервал с началом, концом и шагом;
  • list_metrics — список доступных метрик с постраничным выводом и фильтрами;
  • get_metric_metadata — метаданные одной метрики или нескольких сразу, включая поиск по имени и описанию;
  • get_targets — цели сбора метрик с фильтрацией по состоянию и пулу на стороне сервера;
  • health_check — проверка состояния для мониторинга контейнера.

Дополнительно по README:

  • результаты запросов за интервал можно открыть в интерфейсе Prometheus с тем же окном времени и разрешением. Ссылки отключаются переменной PROMETHEUS_DISABLE_LINKS, чтобы экономить токены;
  • авторизация: basic auth, Bearer-токен и mTLS с клиентским сертификатом;
  • мультитенантность через ORG_ID, свои заголовки через PROMETHEUS_CUSTOM_HEADERS;
  • набор инструментов настраивается: можно оставить только нужные, чтобы не занимать окно контекста;
  • TOOL_PREFIX добавляет префикс к именам инструментов, например staging_execute_query. Это удобно, если несколько экземпляров смотрят в разные окружения;
  • транспорт stdio, HTTP или SSE. HTTP по умолчанию слушает 127.0.0.1:8080.

Кому подойдёт

  • SRE и DevOps-инженерам: разбор инцидентов и проверка гипотез по метрикам в диалоге.
  • Разработчикам, которые не помнят синтаксис PromQL, но хотят быстро посмотреть задержки и ошибки сервиса.
  • Командам на Kubernetes: есть Helm-чарт.

Похожие серверы — в категории облака и DevOps.

Установка

Нужен доступный Prometheus и Docker. Образ: ghcr.io/pab1it0/prometheus-mcp-server:latest. Единственная обязательная переменная — PROMETHEUS_URL. Для авторизации задайте PROMETHEUS_USERNAME и PROMETHEUS_PASSWORD или PROMETHEUS_TOKEN. Есть также установка через каталог MCP в Docker Desktop и Helm-чарт oci://ghcr.io/pab1it0/charts/prometheus-mcp-server.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROMETHEUS_URL",
        "ghcr.io/pab1it0/prometheus-mcp-server:latest"
      ],
      "env": {
        "PROMETHEUS_URL": "<your-prometheus-url>"
      }
    }
  }
}

Для VS Code, Cursor и Windsurf README приводит такой же блок prometheus для настроек MCP в IDE. Подставьте адрес своего Prometheus.

Проверка

Попросите ассистента вызвать health_check, затем показать список метрик или выполнить простой запрос, например up. Если Prometheus использует самоподписанный сертификат, укажите REQUESTS_CA_BUNDLE. Отключать проверку SSL через PROMETHEUS_URL_SSL_VERIFY стоит только в тестовой среде.

Примеры задач

Покажи 95-й перцентиль задержки сервиса api за последний час с шагом 5 минут.
Какие цели сбора метрик сейчас в состоянии down?

Риски

Сервер только читает данные Prometheus, но метрики могут раскрывать внутреннюю структуру инфраструктуры: имена хостов, сервисов и окружений. Меры:

  • передавайте пароль, токен и ключи mTLS через переменные окружения, а не прямо в конфиге, и не коммитьте их;
  • тяжёлые запросы за длинные интервалы нагружают Prometheus. PROMETHEUS_REQUEST_TIMEOUT (по умолчанию 30 секунд) защищает от зависших запросов;
  • HTTP-режим по умолчанию слушает только 127.0.0.1. Не открывайте его наружу без защиты;
  • оставьте ассистенту только нужные инструменты.

Частые вопросы

Может ли сервер что-то изменить в Prometheus?

Нет, инструменты только выполняют запросы и читают метаданные и цели сбора.

Как работать с несколькими окружениями?

Запустите несколько экземпляров с разными PROMETHEUS_URL и разным TOOL_PREFIX.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники