# Prometheus MCP Server

Даёт ИИ-ассистенту доступ к вашим метрикам Prometheus: он выполняет запросы PromQL и разбирает результаты прямо в чате.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 519
- Автор: pab1it0
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pab1it0/prometheus-mcp-server
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/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 с настройкой хоста и порта.

## Требования
- Нужно: Docker
- Переменные окружения: `PROMETHEUS_URL`, `PROMETHEUS_URL_SSL_VERIFY`, `PROMETHEUS_DISABLE_LINKS`, `PROMETHEUS_USERNAME`, `PROMETHEUS_PASSWORD`, `PROMETHEUS_TOKEN`, `ORG_ID`, `PROMETHEUS_CLIENT_CERT`, `PROMETHEUS_CLIENT_KEY`, `PROMETHEUS_MCP_SERVER_TRANSPORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md