Prometheus MCP Server
MCP-сервер для Prometheus: агент выполняет PromQL-запросы, ищет метрики и проверяет цели сбора
Установка
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Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту доступ к Prometheus на чтение. Агент выполняет мгновенные и интервальные PromQL-запросы, получает список метрик с фильтром и постраничным выводом, читает метаданные метрик и состояние целей сбора. Поддерживаются basic auth, Bearer-токен, mTLS и заголовок организации для мультитенантных инсталляций. Набор инструментов можно сократить, а префикс имен позволяет подключить несколько окружений одновременно.
Для кого. Для DevOps- и SRE-инженеров, которые разбирают инциденты и нагрузку по метрикам Prometheus.
Подходит, если
- Нужно быстро понять, что происходило с сервисом во время инцидента
- Нужно составить PromQL-запрос, не помня названия метрик
- Нужно проверить, какие цели сбора упали
Не подходит, если
- Метрики хранятся не в Prometheus-совместимой системе
- Нужно менять правила алертов или конфигурацию Prometheus
Пример запроса к агенту
Покажи, как менялась доля ошибок 5xx у сервиса checkout за последние шесть часовОграничения
Нужен доступный с компьютера адрес Prometheus. README описывает запуск только через Docker-образ и Helm-чарт, поэтому нужен Docker или Kubernetes. Тяжелые запросы по большому интервалу могут нагружать Prometheus, по умолчанию действует таймаут 30 секунд.
Как отключить. Выполните claude mcp remove prometheus или удалите блок prometheus из конфигурации MCP.
MCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| PROMETHEUS_URL обязательная | Адрес сервера Prometheus. |
| PROMETHEUS_USERNAME | Логин для basic auth. |
| PROMETHEUS_PASSWORD секрет | Пароль для basic auth. |
| PROMETHEUS_TOKEN секрет | Bearer-токен. |
| PROMETHEUS_MCP_SERVER_TRANSPORT | stdio, http или sse. |
Проверка безопасности
- Ходит в сеть к Prometheus и читает метрики инфраструктуры
- Может использовать учетные данные доступа к Prometheus
Коротко о README
README дает конфигурации для Claude Desktop, Claude Code, VS Code, Cursor и Windsurf на основе Docker-образа, а также установку через Docker Desktop и Helm-чарт. В таблице перечислены переменные для адреса, авторизации, TLS, таймаута, транспорта и префикса инструментов. Описаны шесть инструментов для запросов и поиска метрик. Проект на Python с тестами, лицензия MIT.
Частые вопросы
Может ли агент что-то изменить в Prometheus?
Нет, все инструменты сервера только читают данные.
Как подключить Prometheus с авторизацией?
Через PROMETHEUS_USERNAME и PROMETHEUS_PASSWORD, PROMETHEUS_TOKEN или сертификаты mTLS.
Похожие
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
GitHub Action, который запускает Claude Code в pull requests и issues: отвечает на упоминания, делает ревью и вносит правки
AI-помощник для Kubernetes: переводит запросы на естественном языке в операции kubectl и работает как MCP-сервер