mcp-victoriametrics

mcp-victoriametrics

VictoriaMetricsApache-2.0
174 звёзд24 форков
MCP-сервер для VictoriaMetrics. Подключает AI-ассистента к вашим метрикам, API и документации. Работаете с VictoriaMetrics? Поручите ассистенту выполнить запрос PromQL, проверить кардинальность или отладить правила — всё в одном диалоге. Сервер работает только на чтение, изменения в данных исключены. Подходит даже для продакшена.
Development
Открыть на GitHub

Характеристики

Общее

  • СтатусСообщество
  • РазработчикVictoriaMetrics
  • ЛицензияApache-2.0

Технологии

  • Языки
    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-клиенты

Поделиться