
mcp-victoriametrics
VictoriaMetricsv1.21.0Apache-2.0
247 звёзд38 форков
MCP-сервер для VictoriaMetrics. Подключает AI-ассистента к вашим метрикам, API и документации.
Работаете с VictoriaMetrics? Поручите ассистенту выполнить запрос PromQL, проверить кардинальность или отладить правила — всё в одном диалоге. Сервер работает только на чтение, изменения в данных исключены. Подходит даже для продакшена.
- Официальный сервер
- Локальный запуск (stdio)
- Go
- Лицензия Apache-2.0
- Обновлён 21 ноября 2026 г.
Подключение
Подключить mcp-victoriametrics
Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.
1
Способ подключения
2
Куда подключить
3
Скопируйте и проверьте
Claude Desktop / Claude Code
Клиент запускает MCP-сервер как локальный процесс.
- 1.Откройте настройки MCP в Claude.
- 2.Добавьте сервер с указанной командой и переменными окружения.
- 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
"mcpServers": {
"mcp-victoriametrics-VictoriaMetrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "<VM_INSTANCE_ENTRYPOINT>",
"VM_INSTANCE_TYPE": "<VM_INSTANCE_TYPE>",
"VM_INSTANCE_BEARER_TOKEN": "<VM_INSTANCE_BEARER_TOKEN>"
}
}
}
}Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.
Характеристики
Общее
- СтатусОфициальный
- РазработчикVictoriaMetrics
- Версияv1.21.0
- ЛицензияApache-2.0
- Последний релиз12.11.2026
- Активность источника21.11.2026
Технологии
- ЯзыкиGo
- Транспортstdio — локальный запуск
Описание
Возможности
- Запрашивает метрики через PromQL и MetricsQL — возвращает сырые или агрегированные данные
- Показывает список метрик, меток и их значений в заданном диапазоне времени
- Экспортирует временные ряды для внешнего анализа
- Проверяет правила алертинга и рекординга — выполняет их и возвращает результат
- Анализирует кардинальность: находит метрики, потребляющие больше всего временных рядов
- Разбирает сложные запросы: трассировка, форматирование, советы по оптимизации
- Диагностирует relabeling правила, downsampling и политики хранения (retention)
- Ищет по документации VictoriaMetrics — вся база знаний встроена, интернет не нужен
- Взаимодействует с VictoriaMetrics Cloud: те же функции для облачных инстансов
- Строит графики метрик, если клиент поддерживает вывод изображений
Как подключить
Установите сервер через Go:
go install github.com/VictoriaMetrics/mcp-victoriametrics@latest
Добавьте конфигурацию в claude_desktop_config.json:
{ "mcpServers": { "victoriametrics": { "command": "mcp-victoriametrics", "args": [], "env": { "VM_SERVER_URL": "http://localhost:8428" } } } }
Укажите адрес вашего инстанса VictoriaMetrics. Для облачной версии передайте токен авторизации. Перезапустите Claude Desktop. Сервер готов к работе.
Примеры запросов
- «Найди метрики с самой высокой кардинальностью. Покажи топ-10 и объясни причину.»
- «Объясни, что делает этот запрос: rate(http_requests_total{job="api"}[5m]) > 0.5»
- «Протестируй мои правила алертинга: groups: [...]»
- «Покажи все значения метки instance для метрики node_cpu_seconds_total.»
- «Нарисуй график запросов к сервису за последние 24 часа.»
Технические детали
- Язык: Go
- Транспорт: stdio (поддерживает Streamable HTTP)
- Лицензия: Apache 2.0
- Совместимость: Claude Desktop, Claude Code, Cline, любые MCP-клиенты




