mcp-vmanomaly — MCP-сервер для Claude Code
Подключает ИИ-ассистента к REST API vmanomaly. Помогает настраивать детекцию аномалий во временных рядах VictoriaMetrics и генерировать правила алертов.
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Что делает 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 или выше.
Какие задачи решает
- Сгенерировать YAML-конфигурацию для обнаружения аномалий в метриках
- Подобрать параметры модели через autotune по выборке временных рядов
- Сформировать правила алертов для vmalert на базе anomaly score
- Найти инструкции в локальной документации vmanomaly без доступа в сеть
Примеры запросов агенту
- Проверь статус сервера vmanomaly и выведи информацию о сборке
- Сгенерируй алерт для vmalert на основе anomaly score для метрики загрузки CPU
- Подбери конфигурацию модели vmanomaly для временного ряда через autotune
Как установить mcp-vmanomaly
Командой платформы
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 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 сервера
Файл настроек
{
"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 сервера
Файл настроек
{
"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 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 сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-vmanomaly
Как установить mcp-vmanomaly в Claude Code?
Выполните команду в терминале: `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`. Значения в угловых скобках замените на параметры своего подключения.
Что делает mcp-vmanomaly?
Сервер даёт ИИ доступ к REST API vmanomaly для проверки состояния сервиса, валидации моделей детекции и генерации конфигов. Также он создаёт правила для vmalert и ищет ответы во встроенной документации.
Какая версия vmanomaly нужна для работы?
Для базовых функций требуется версия 1.28.3 или новее. Специфические сценарии autotune и профилирования рядов требуют версий 1.30.0, 1.30.5 или 1.31.0.
