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; метрики раскрывают структуру инфраструктуры; учётные данные — через переменные окружения.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.