# Prometheus MCP Server

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

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

## Требования
- Нужно: Docker

## Установка

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

**Командой платформы**
```bash
claude mcp add prometheus-prometheus-mcp-server -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0
```

### Codex

**Командой платформы**
```bash
codex mcp add prometheus-prometheus-mcp-server -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prometheus-prometheus-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "prometheus-prometheus-mcp-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add prometheus-prometheus-mcp-server docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0
```

## Когда брать
- разобраться, почему PromQL-запрос тормозит
- посмотреть активные алерты и загруженные правила
- проверить, какие цели Prometheus вообще видит
- найти метрики и метки по матчерам
- оценить кардинальность и статистику TSDB

## Примеры запросов агенту
- Запросы к метрикам идут медленно, помоги понять почему
- Покажи активные алерты и правила, которые сейчас загружены
- Посмотри статистику TSDB и скажи, где высокая кардинальность

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

## Другие версии с тем же именем
- [Prometheus MCP Server · pab1it0](https://affpapa.org/nevibecode/mcp/prometheus-mcp-server.md) — ★ 519

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