Prometheus MCP Server
Официальный MCP-сервер Prometheus: PromQL-запросы, метрики, правила и оповещения плюс встроенные runbook для разбора проблем.
- 135 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструменты `quit` и `reload` могут остановить Prometheus или перечитать его конфигурацию.
- С флагом администрирования TSDB агент способен удалять ряды и снимать снимки данных.
Установка
- Работает в
Ручная установка
PROMETHEUS_MCP_PROMETHEUS_URL="https://$yourPrometheus:9090" /path/to/prometheus-mcpБинарный файл берут на странице Releases; README также описывает Docker, Helm и systemd.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструменты `quit` и `reload` могут остановить Prometheus или перечитать его конфигурацию.
- С флагом администрирования TSDB агент способен удалять ряды и снимать снимки данных.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Официальный MCP-сервер проекта Prometheus подключает агента к работающему экземпляру Prometheus через его HTTP API. Агент выполняет мгновенные и диапазонные запросы PromQL, перечисляет метрики, метки и ряды, читает конфигурацию, флаги, цели сбора, правила и активные оповещения. Кроме API, сервер отдает официальную документацию Prometheus и семь встроенных runbook в формате Agent Skills: проверка здоровья, поиск главных потребителей ресурсов, разбор частоты ошибок, оптимизация высокой кардинальности, ревью правил, поиск причин пропавших данных и настройка конфигурации. Ответы можно сжать форматом TOON или усечением. Транспорт stdio или HTTP; для Thanos есть отдельный набор инструментов.
Для кого. Инженерам SRE и владельцам Prometheus, которые разбирают метрики и оповещения через агента, не набирая PromQL вручную.
Подходит, если
- Запросы к метрикам тормозят, и агент ищет метрики с высокой кардинальностью.
- После релиза выросла доля ошибок, и нужно найти сервис, который ее дает.
- Агент пишет правила записи для SLO на основе реальных метрик сервера.
- Цели сбора пропали из списка, а причину ищут по конфигурации и статусу целей.
Не подходит, если
- Метрики лежат в системе без Prometheus-совместимого API.
- Доступ агента к управляющим эндпоинтам Prometheus недопустим.
- Ответы с большим числом рядов переполнят контекст при ненастроенном усечении.
Пример запроса к агенту
Проверь здоровье Prometheus: покажи цели сбора с ошибками, активные оповещения и десять метрик с самой высокой кардинальностью.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
PROMETHEUS_MCP_PROMETHEUS_URLобязательная- Адрес сервера Prometheus.
Ограничения
Управляющие инструменты `quit` и `reload` регистрируются по умолчанию и действуют, если на самом Prometheus включен управляющий API. Урезайте набор флагом `--mcp.tools`. Инструменты администрирования TSDB (`delete_series`, `clean_tombstones`, `snapshot`) выключены и включаются флагом `--dangerous.enable-tsdb-admin-tools`. HTTP-транспорт без защиты открывает запросы к Prometheus каждому, кто достучится до `/mcp`, а заголовок `Authorization` пересылается дальше без проверки. У совместимых систем вроде Thanos часть эндпоинтов отсутствует, и инструменты возвращают 404.
Как отключить. Удалите запись сервера из настроек клиента и остановите процесс `prometheus-mcp` или контейнер. На самом Prometheus ничего не остается.
Частые вопросы
Какие инструменты нужны для запросов?
Хватит `query` и `range_query`. Для поиска имен служат `metric_metadata`, `label_names`, `label_values` и `series`: они всегда загружены.
Как уменьшить расход токенов?
Включите усечение ответов и формат TOON. README не обещает выигрыш: он зависит от формы данных, поэтому сравните оба формата на своих запросах.
Как подключить защищенный Prometheus?
Передайте файл HTTP-конфигурации Prometheus флагом `--http.config`. Если файл нечитаем или неверен, сервер завершится при старте и не пойдет без аутентификации.
Что такое runbook в этом сервере?
Это встроенные руководства в формате Agent Skills для типовых задач: проверка здоровья, разбор ошибок, кардинальность. Их читают инструменты `runbooks_list` и `runbooks_read` или запросом промпта.
Работает ли сервер с Thanos?
Да, флаг `--prometheus.backend` выбирает набор для Thanos. Несовместимые инструменты вроде `config` и `reload` в нем убраны, `list_stores` добавлен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Prometheus: агент выполняет PromQL-запросы, ищет метрики и проверяет цели сбора
Grafana MCP Server
Grafana MCP server
Официальный MCP-сервер Grafana: дашборды, запросы к Prometheus и Loki, алерты и инциденты прямо из агента
Официальный MCP-сервер Nightingale: агент читает алерты и метрики, ведет правила оповещений и дашборды системы мониторинга
Официальный управляемый MCP-сервер Datadog: логи, метрики, трейсы и инциденты прямо в агенте
Zabbix MCP Server (mpeirone)
Zabbix MCP Server
MCP-сервер открывает агенту методы Zabbix API через вызов, справку и поиск методов с настройками чтения и разрешенных операций.
Datadog MCP Server (winor30)
Datadog MCP Server
Независимый MCP-сервер Datadog: агент читает инциденты, мониторы, логи, метрики, трейсы и RUM и планирует простои.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Prometheus MCP Server (эта карточка) | да | не нужна | 135 | |
| Prometheus MCP Server | нет | не нужна | 522 | сообщественный сервер для чтения метрик; здесь официальный выпуск проекта с runbook, документацией и режимом Thanos |
| Grafana MCP Server | да | API-ключ | 3 641 | работает через Grafana и ее источники данных; Prometheus MCP обращается к HTTP API Prometheus напрямую |
Коротко о README
Сервер выдает JSON из HTTP API как есть и умеет сжимать его в TOON. Документация Prometheus и руководства встроены и читаются через сам сервер.