# mcp-victoriametrics

Подключает Claude Code к базам VictoriaMetrics для выполнения метрических запросов, проверки правил алертинга и чтения встроенной документации.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 240
- Автор: VictoriaMetrics
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/VictoriaMetrics/mcp-victoriametrics
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/victoriametrics-mcp-victoriametrics

## Что делает

Сервер открывает ИИ-агенту доступ к метрикам через read-only API VictoriaMetrics. С его помощью модель выполняет запросы к данным, анализирует кардинальность лейблов, просматривает временные ряды и разбирает правила алертинга. Если клиент умеет рендерить графику, инструмент передаёт данные для построения графиков прямо в диалог.

Внутрь бинарника зашита актуальная документация VictoriaMetrics, поэтому агент находит справку по синтаксису и параметрам конфигурации без выхода в интернет. Для работы нужен доступ к инстансу VictoriaMetrics (одиночному или кластерному) либо аккаунт в VictoriaMetrics Cloud. Без корректного адреса в переменной `VM_INSTANCE_ENTRYPOINT` сервер не сможет получить метрики. Для первичных тестов доступен публичный плейграунд `https://play-mcp.victoriametrics.com/mcp`.

## Требования
- Нужно: Docker
- Переменные окружения: `VM_INSTANCE_ENTRYPOINT`, `VM_INSTANCE_TYPE`, `VM_INSTANCE_BEARER_TOKEN`, `VMC_API_KEY`, `MCP_DISABLED_TOOLS`, `MCP_DISABLE_RESOURCES`, `MCP_PASSTHROUGH_HEADERS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env VM_INSTANCE_ENTRYPOINT=<VM_INSTANCE_ENTRYPOINT> --env VM_INSTANCE_TYPE=<VM_INSTANCE_TYPE> --env VM_INSTANCE_BEARER_TOKEN=<VM_INSTANCE_BEARER_TOKEN> --env VMC_API_KEY=<VMC_API_KEY> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio victoriametrics-mcp-victoriametrics -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add victoriametrics-mcp-victoriametrics --env VM_INSTANCE_ENTRYPOINT=<VM_INSTANCE_ENTRYPOINT> --env VM_INSTANCE_TYPE=<VM_INSTANCE_TYPE> --env VM_INSTANCE_BEARER_TOKEN=<VM_INSTANCE_BEARER_TOKEN> --env VMC_API_KEY=<VMC_API_KEY> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "victoriametrics-mcp-victoriametrics": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "VM_INSTANCE_ENTRYPOINT",
                "-e",
                "VM_INSTANCE_TYPE",
                "-e",
                "VM_INSTANCE_BEARER_TOKEN",
                "-e",
                "VMC_API_KEY",
                "-e",
                "MCP_DISABLED_TOOLS",
                "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
            ],
            "env": {
                "VM_INSTANCE_ENTRYPOINT": "<VM_INSTANCE_ENTRYPOINT>",
                "VM_INSTANCE_TYPE": "<VM_INSTANCE_TYPE>",
                "VM_INSTANCE_BEARER_TOKEN": "<VM_INSTANCE_BEARER_TOKEN>",
                "VMC_API_KEY": "<VMC_API_KEY>",
                "MCP_DISABLED_TOOLS": "<MCP_DISABLED_TOOLS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "victoriametrics-mcp-victoriametrics": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "VM_INSTANCE_ENTRYPOINT",
                "-e",
                "VM_INSTANCE_TYPE",
                "-e",
                "VM_INSTANCE_BEARER_TOKEN",
                "-e",
                "VMC_API_KEY",
                "-e",
                "MCP_DISABLED_TOOLS",
                "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
            ],
            "env": {
                "VM_INSTANCE_ENTRYPOINT": "<VM_INSTANCE_ENTRYPOINT>",
                "VM_INSTANCE_TYPE": "<VM_INSTANCE_TYPE>",
                "VM_INSTANCE_BEARER_TOKEN": "<VM_INSTANCE_BEARER_TOKEN>",
                "VMC_API_KEY": "<VMC_API_KEY>",
                "MCP_DISABLED_TOOLS": "<MCP_DISABLED_TOOLS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e VM_INSTANCE_ENTRYPOINT=<VM_INSTANCE_ENTRYPOINT> -e VM_INSTANCE_TYPE=<VM_INSTANCE_TYPE> -e VM_INSTANCE_BEARER_TOKEN=<VM_INSTANCE_BEARER_TOKEN> -e VMC_API_KEY=<VMC_API_KEY> -e MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> victoriametrics-mcp-victoriametrics docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

## Когда брать
- Выполнять метрические запросы и экспортировать временные ряды
- Оценивать кардинальность меток и статистику использования метрик
- Тестировать и отлаживать правила алертинга и записи

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

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