# mcp-vmanomaly

Подключает ИИ-ассистента к REST API vmanomaly. Помогает настраивать детекцию аномалий во временных рядах VictoriaMetrics и генерировать правила алертов.

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

## Что делает

Сервер связывает модели Claude или других ассистентов с сервисом `vmanomaly` через REST API. Он умеет запрашивать статус сервиса, валидировать конфигурации моделей и выполнять поиск по встроенной документации без выхода в интернет.

Инструмент профилирует срезы метрик и подбирает параметры конфигурации через процедуру autotune сразу для нескольких рядов. На основе метрик anomaly score сервер формирует готовые YAML-конфигурации для `vmanomaly` и правила оповещений для `vmalert`.

Для работы нужен запущенный инстанс `vmanomaly` с открытым REST API: базовые вызовы требуют версию от 1.28.3, а расширенный autotune — от 1.30.0. Если собирать сервер из исходного кода, потребуется Go 1.26.9 или выше.

## Требования
- Нужно: Docker
- Переменные окружения: `VMANOMALY_ENDPOINT`, `VMANOMALY_BEARER_TOKEN`, `VMANOMALY_BEARER_TOKEN_FILE`, `VMANOMALY_HEADERS`, `MCP_SERVER_MODE`, `MCP_LISTEN_ADDR`, `MCP_LOG_LEVEL`, `MCP_LOG_FILE`, `MCP_ENABLED_TOOLS`, `MCP_DISABLED_TOOLS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env VMANOMALY_ENDPOINT=<VMANOMALY_ENDPOINT> --env VMANOMALY_BEARER_TOKEN=<VMANOMALY_BEARER_TOKEN> --env VMANOMALY_BEARER_TOKEN_FILE=<VMANOMALY_BEARER_TOKEN_FILE> --env VMANOMALY_HEADERS=<VMANOMALY_HEADERS> --env MCP_SERVER_MODE=<MCP_SERVER_MODE> --transport stdio victoriametrics-mcp-vmanomaly -- docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_BEARER_TOKEN_FILE -e VMANOMALY_HEADERS -e MCP_SERVER_MODE ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add victoriametrics-mcp-vmanomaly --env VMANOMALY_ENDPOINT=<VMANOMALY_ENDPOINT> --env VMANOMALY_BEARER_TOKEN=<VMANOMALY_BEARER_TOKEN> --env VMANOMALY_BEARER_TOKEN_FILE=<VMANOMALY_BEARER_TOKEN_FILE> --env VMANOMALY_HEADERS=<VMANOMALY_HEADERS> --env MCP_SERVER_MODE=<MCP_SERVER_MODE> -- docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_BEARER_TOKEN_FILE -e VMANOMALY_HEADERS -e MCP_SERVER_MODE ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "victoriametrics-mcp-vmanomaly": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "VMANOMALY_ENDPOINT",
                "-e",
                "VMANOMALY_BEARER_TOKEN",
                "-e",
                "VMANOMALY_BEARER_TOKEN_FILE",
                "-e",
                "VMANOMALY_HEADERS",
                "-e",
                "MCP_SERVER_MODE",
                "ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1"
            ],
            "env": {
                "VMANOMALY_ENDPOINT": "<VMANOMALY_ENDPOINT>",
                "VMANOMALY_BEARER_TOKEN": "<VMANOMALY_BEARER_TOKEN>",
                "VMANOMALY_BEARER_TOKEN_FILE": "<VMANOMALY_BEARER_TOKEN_FILE>",
                "VMANOMALY_HEADERS": "<VMANOMALY_HEADERS>",
                "MCP_SERVER_MODE": "<MCP_SERVER_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "victoriametrics-mcp-vmanomaly": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "VMANOMALY_ENDPOINT",
                "-e",
                "VMANOMALY_BEARER_TOKEN",
                "-e",
                "VMANOMALY_BEARER_TOKEN_FILE",
                "-e",
                "VMANOMALY_HEADERS",
                "-e",
                "MCP_SERVER_MODE",
                "ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1"
            ],
            "env": {
                "VMANOMALY_ENDPOINT": "<VMANOMALY_ENDPOINT>",
                "VMANOMALY_BEARER_TOKEN": "<VMANOMALY_BEARER_TOKEN>",
                "VMANOMALY_BEARER_TOKEN_FILE": "<VMANOMALY_BEARER_TOKEN_FILE>",
                "VMANOMALY_HEADERS": "<VMANOMALY_HEADERS>",
                "MCP_SERVER_MODE": "<MCP_SERVER_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e VMANOMALY_ENDPOINT=<VMANOMALY_ENDPOINT> -e VMANOMALY_BEARER_TOKEN=<VMANOMALY_BEARER_TOKEN> -e VMANOMALY_BEARER_TOKEN_FILE=<VMANOMALY_BEARER_TOKEN_FILE> -e VMANOMALY_HEADERS=<VMANOMALY_HEADERS> -e MCP_SERVER_MODE=<MCP_SERVER_MODE> victoriametrics-mcp-vmanomaly docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_BEARER_TOKEN_FILE -e VMANOMALY_HEADERS -e MCP_SERVER_MODE ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

## Когда брать
- Сгенерировать YAML-конфигурацию для обнаружения аномалий в метриках
- Подобрать параметры модели через autotune по выборке временных рядов
- Сформировать правила алертов для vmalert на базе anomaly score
- Найти инструкции в локальной документации vmanomaly без доступа в сеть

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

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