Prometheus MCP Server · pab1it0 — MCP-сервер для Claude Code: запросы PromQL
Даёт ИИ-ассистенту доступ к вашим метрикам Prometheus: он выполняет запросы PromQL и разбирает результаты прямо в чате.
claude mcp add --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Что делает Prometheus MCP Server
Сервер поднимает между ассистентом и Prometheus стандартный интерфейс MCP. Внутри набор инструментов: execute_query для instant-запроса, execute_range_query с началом, концом и шагом, list_metrics со списком метрик и пагинацией, get_metric_metadata, get_targets и health_check для проверки состояния контейнера.
Запускается в Docker из образа ghcr.io/pab1it0/prometheus-mcp-server:1.6.2. Обязательна одна переменная — PROMETHEUS_URL с адресом вашего сервера. Остальное по желанию: basic-аутентификация (PROMETHEUS_USERNAME, PROMETHEUS_PASSWORD), bearer-токен, взаимный TLS через PROMETHEUS_CLIENT_CERT и PROMETHEUS_CLIENT_KEY, отключение SSL-проверки, таймаут запроса и ORG_ID для мультитенантных установок.
Есть нюанс с контекстом. По умолчанию сервер добавляет в результаты ссылки на UI Prometheus, и они съедают токены — PROMETHEUS_DISABLE_LINKS=True их убирает. Для нескольких окружений в Cursor пригодится TOOL_PREFIX: имена инструментов получат префикс, и два экземпляра не перепутаются. Транспорт по умолчанию stdio, но есть http и sse с настройкой хоста и порта.
Какие задачи решает
- выполнить PromQL-запрос к метрикам, не открывая UI Prometheus
- посмотреть список доступных метрик и их метаданные
- снять range-запрос за нужный интервал с заданным шагом
- проверить scrape-таргеты и их состояние
- развести два экземпляра сервера по разным окружениям в одном редакторе
Примеры запросов агенту
- Выполни instant-запрос
upи покажи, какие таргеты сейчас недоступны - Сделай range-запрос
rate(http_requests_total[5m])за последний час с шагом 1m - Выведи список метрик, начинающихся на
node_, и их метаданные
Как установить Prometheus MCP Server
Командой платформы
claude mcp add --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
codex mcp add prometheus-mcp-server --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"prometheus-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"-e",
"PROMETHEUS_URL_SSL_VERIFY",
"-e",
"PROMETHEUS_DISABLE_LINKS",
"-e",
"PROMETHEUS_USERNAME",
"-e",
"PROMETHEUS_PASSWORD",
"ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
],
"env": {
"PROMETHEUS_URL": "<PROMETHEUS_URL>",
"PROMETHEUS_URL_SSL_VERIFY": "<PROMETHEUS_URL_SSL_VERIFY>",
"PROMETHEUS_DISABLE_LINKS": "<PROMETHEUS_DISABLE_LINKS>",
"PROMETHEUS_USERNAME": "<PROMETHEUS_USERNAME>",
"PROMETHEUS_PASSWORD": "<PROMETHEUS_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"prometheus-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"-e",
"PROMETHEUS_URL_SSL_VERIFY",
"-e",
"PROMETHEUS_DISABLE_LINKS",
"-e",
"PROMETHEUS_USERNAME",
"-e",
"PROMETHEUS_PASSWORD",
"ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
],
"env": {
"PROMETHEUS_URL": "<PROMETHEUS_URL>",
"PROMETHEUS_URL_SSL_VERIFY": "<PROMETHEUS_URL_SSL_VERIFY>",
"PROMETHEUS_DISABLE_LINKS": "<PROMETHEUS_DISABLE_LINKS>",
"PROMETHEUS_USERNAME": "<PROMETHEUS_USERNAME>",
"PROMETHEUS_PASSWORD": "<PROMETHEUS_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e PROMETHEUS_URL=<PROMETHEUS_URL> -e PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> -e PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> -e PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> -e PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> prometheus-mcp-server docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Prometheus MCP Server
Как установить Prometheus MCP Server в Claude Code?
Одной командой: `claude mcp add --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2`
Что делает Prometheus MCP Server?
Открывает ассистенту инструменты для работы с Prometheus: instant- и range-запросы PromQL, список метрик, метаданные, scrape-таргеты и health check.
Что нужно для запуска?
Доступный из вашего окружения сервер Prometheus и Docker. Переменная PROMETHEUS_URL обязательна, остальные параметры — аутентификация, TLS, таймаут — задаются по необходимости.
Похожие MCP-серверы
Все MCP-серверы по теме «DevOps и инфраструктура» →Сначала — Prometheus MCP Server от других авторов.
