mcp-victoriametrics

mcp-victoriametrics

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

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

Общее

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

Технологии

  • Языки
    Go
  • Транспорт
    stdio

Описание

Возможности

  • Выполнять PromQL и MetricsQL запросы. Если клиент поддерживает графику, сервер отрисует график прямо в чате.
  • Получать списки метрик, меток, значений меток и временных рядов. Экспортировать эти данные.
  • Тестировать правила алертинга и recording rules. Сервер проверит синтаксис и соответствие документации.
  • Просматривать параметры инстанса: версию, флаги запуска, статус.
  • Исследовать кардинальность данных — находить метрики и метки, создающие избыточную нагрузку.
  • Анализировать и объяснять сложные PromQL-запросы. Сервер разбивает запрос на части и поясняет каждую.
  • Отлаживать relabeling-конфигурации, настройки downsampling и политики хранения (retention).
  • Работать с VictoriaMetrics Cloud через встроенный API-клиент.
  • Искать информацию во встроенной документации VictoriaMetrics. Документация обновляется вместе с сервером и доступна офлайн.
  • Просматривать список инструментов и инструкции по настройке в браузере (в режиме Streamable HTTP).

Как подключить

1. Установите сервер. Если используете Go:

go install github.com/VictoriaMetrics/mcp-victoriametrics@latest

Или через Docker:

docker pull victoriametrics/mcp-victoriametrics

2. Добавьте конфигурацию в файл настроек вашего MCP-клиента. Для Claude Desktop (claude_desktop_config.json):

{ "mcpServers": { "victoriametrics": { "command": "mcp-victoriametrics", "args": ["--url", "http://localhost:8428"] } } }

3. Перезапустите клиент. Через несколько секунд в интерфейсе появятся инструменты для работы с VictoriaMetrics.

Примеры запросов

  • «Покажи среднюю загрузку CPU за последний час по всем хостам в кластере prod c группировкой по зонам доступности.»
  • «Объясни запрос: histogram_quantile(0.99, sum(rate(http_request_duration_seconds_bucket[5m])) by (le)). Что он измеряет и где применяется?»
  • «Проверь мой relabeling-конфиг: замени метку environment на env и удали метку temp. Напиши правильный YAML.»
  • «Найди в документации VictoriaMetrics описание настройки downsampling и напиши краткую инструкцию по агрегации старых данных.»

Технические детали

  • Язык разработки: Go
  • Транспорт: stdio (поддерживает Streamable HTTP)
  • Лицензия: Apache 2.0
  • Разработчик: VictoriaMetrics
  • Совместимость: Claude Desktop, Cursor, любые MCP-клиенты

Поделиться