Prometheus MCP Server · prometheus — MCP-сервер для Claude Code: PromQL и метрики
Даёт ИИ-агенту доступ к вашему Prometheus через API: выполнять PromQL-запросы, смотреть метрики, алерты и цели. Пригодится, когда разбираете медленные запросы или здоровье инстанса.
claude mcp add prometheus-prometheus-mcp-server -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0Что делает Prometheus MCP Server
Сервер подключается к запущенному инстансу Prometheus и отдаёт агенту его HTTP API. Инструменты возвращают JSON, который модель разбирает сама: query и range_query для мгновенных и диапазонных запросов, series, label_names, label_values, metric_metadata для работы с метками и метриками, list_alerts, list_rules, list_targets, tsdb_stats для обзора состояния. Есть и раздел с официальной документацией Prometheus: docs_list, docs_read, docs_search.
Если контекст жмёт, можно включить кодирование ответов в TOON или ограничить число строк и записей, которые возвращает API. Ограничение по умолчанию выключено, а значение 0 его отключает; для части инструментов агент может переопределить лимит на отдельном вызове.
Управляющие эндпоинты вроде quit и reload доступны сразу. А вот TSDB Admin API, через который можно удалять данные, по умолчанию выключен: чтобы его включить, сервер запускают с флагом --dangerous.enable-tsdb-admin-tools. Без этой опции разрушительные операции агенту недоступны, и это скорее хорошо.
Какие задачи решает
- разобраться, почему PromQL-запрос тормозит
- посмотреть активные алерты и загруженные правила
- проверить, какие цели Prometheus вообще видит
- найти метрики и метки по матчерам
- оценить кардинальность и статистику TSDB
Примеры запросов агенту
- Запросы к метрикам идут медленно, помоги понять почему
- Покажи активные алерты и правила, которые сейчас загружены
- Посмотри статистику TSDB и скажи, где высокая кардинальность
Как установить Prometheus MCP Server
Командой платформы
claude mcp add prometheus-prometheus-mcp-server -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0Командой платформы
codex mcp add prometheus-prometheus-mcp-server -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0Файл настроек
{
"mcpServers": {
"prometheus-prometheus-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
]
}
}
}Файл настроек
{
"servers": {
"prometheus-prometheus-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
]
}
}
}Командой платформы
gemini mcp add prometheus-prometheus-mcp-server docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Prometheus MCP Server
Как установить Prometheus MCP Server в Claude Code?
Одной командой: claude mcp add prometheus-prometheus-mcp-server -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0. Docker должен быть доступен, потому что сервер запускается в контейнере.
Что делает Prometheus MCP Server?
Подключает агента к запущенному Prometheus через API. Агент выполняет PromQL-запросы, смотрит метрики, алерты, цели, правила и статистику TSDB, а также ищет по официальной документации Prometheus.
Можно ли через него удалять данные в Prometheus?
Только если запустить сервер с флагом --dangerous.enable-tsdb-admin-tools. Без него TSDB Admin API выключен, и разрушительные операции недоступны.
Похожие MCP-серверы
Все MCP-серверы по теме «DevOps и инфраструктура» →Сначала — Prometheus MCP Server от других авторов.
