mcp-victoriametrics — MCP-сервер для Claude Code: как установить
Подключает Claude Code к базам VictoriaMetrics для выполнения метрических запросов, проверки правил алертинга и чтения встроенной документации.
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Что делает mcp-victoriametrics
Сервер открывает ИИ-агенту доступ к метрикам через read-only API VictoriaMetrics. С его помощью модель выполняет запросы к данным, анализирует кардинальность лейблов, просматривает временные ряды и разбирает правила алертинга. Если клиент умеет рендерить графику, инструмент передаёт данные для построения графиков прямо в диалог.
Внутрь бинарника зашита актуальная документация VictoriaMetrics, поэтому агент находит справку по синтаксису и параметрам конфигурации без выхода в интернет. Для работы нужен доступ к инстансу VictoriaMetrics (одиночному или кластерному) либо аккаунт в VictoriaMetrics Cloud. Без корректного адреса в переменной VM_INSTANCE_ENTRYPOINT сервер не сможет получить метрики. Для первичных тестов доступен публичный плейграунд https://play-mcp.victoriametrics.com/mcp.
Какие задачи решает
- Выполнять метрические запросы и экспортировать временные ряды
- Оценивать кардинальность меток и статистику использования метрик
- Тестировать и отлаживать правила алертинга и записи
- Искать информацию по настройкам во встроенной документации без сети
Примеры запросов агенту
- Покажи десять метрик с самой высокой кардинальностью из нашего кластера
- Проверь правила алертинга и объясни, почему срабатывает алерт high_cpu_usage
- Найди в локальной документации параметры настройки политик ретеншена
Как установить mcp-victoriametrics
Командой платформы
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 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 сервера
Файл настроек
{
"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 сервера
Файл настроек
{
"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 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 сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-victoriametrics
Как установить mcp-victoriametrics в Claude Code?
Выполните команду `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`. Замените плейсхолдеры на реальные параметры подключения к базе.
Что делает mcp-victoriametrics?
Он читает метрики, анализирует структуру лейблов, проверяет конфигурацию алертов и объясняет метрические запросы. Также сервер ищет ответы в локальной копии документации.
Можно ли протестировать сервер без своего инстанса VictoriaMetrics?
Да, разработчики поддерживают публичную тестовую конечную точку https://play-mcp.victoriametrics.com/mcp. Она работает в режиме Streamable HTTP и подключена к общедоступному плейграунду проекта.
