VictoriaMetrics MCP Server
Официальный MCP-сервер VictoriaMetrics: запросы метрик, правила и алерты, кардинальность и встроенная документация для агента
- 244 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Токен открывает метрики и конфигурацию экземпляра, а в метриках бывают внутренние имена сервисов и хостов
- Сетевой режим без `MCP_AUTH_TOKEN` оставляет порт без аутентификации
Установка
- Работает в
Ручная установка
claude mcp add victoriametrics -e VM_INSTANCE_ENTRYPOINT=<YOUR_VM_INSTANCE> -e VM_INSTANCE_TYPE=<YOUR_VM_INSTANCE_TYPE> -e VM_INSTANCE_BEARER_TOKEN=<YOUR_VM_BEARER_TOKEN> -- /path/to/mcp-victoriametricsБинарник берут со страницы релизов; для HTTP-режима `claude mcp add victoriametrics --transport http http://localhost:8080/mcp`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен открывает метрики и конфигурацию экземпляра, а в метриках бывают внутренние имена сервисов и хостов
- Сетевой режим без `MCP_AUTH_TOKEN` оставляет порт без аутентификации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту почти все API VictoriaMetrics только для чтения, то есть то, что доступно в интерфейсе VMUI. Агент выполняет мгновенные и диапазонные запросы (`query`, `query_range`), перечисляет метрики, метки и серии, смотрит правила и алерты, разбирает и объясняет запросы (`explain_query`, `prettify_query`), показывает самые тяжелые запросы и статистику TSDB о кардинальности данных. Отдельные инструменты отлаживают релейблинг, даунсэмплинг и политику хранения. В сервер встроена актуальная документация, поиск по ней работает без выхода в сеть. Есть интеграция с VictoriaMetrics Cloud через ключ API и готовые промпты вроде поиска редко используемых метрик с высокой кардинальностью. Режимы запуска: stdio по умолчанию, SSE и Streamable HTTP с конечной точкой `/mcp`, токен для входящих запросов задают переменной `MCP_AUTH_TOKEN`.
Для кого. Инженерам SRE и DevOps, которые держат метрики в VictoriaMetrics и хотят разбирать инциденты и тяжелые запросы вместе с агентом.
Подходит, если
- Сработал алерт, и агент собирает связанные метрики за последний час и сравнивает с обычным уровнем
- Кластер тормозит из-за кардинальности, и агент ищет метрики с самым большим числом серий и редко используемые
- Запрос PromQL работает медленно, и агент объясняет его план и ищет упрощение
- Правила релейблинга или хранения проверяют отладчиками до выкатки
Не подходит, если
- Нужно менять данные или конфигурацию кластера: сервер использует почти только чтение
- VictoriaMetrics у вас нет: сервер подключается к экземпляру vmsingle или vmselect
- Хватит самого VMUI: агент добавляет пользу, когда запросы и выводы нужно связать с другими данными
Пример запроса к агенту
Найди метрики с самой высокой кардинальностью за последние сутки, покажи, какие из них не запрашивались, и объясни самый тяжелый запросMCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
VM_INSTANCE_ENTRYPOINTобязательная- Корневой адрес vmsingle или vmselect
VM_INSTANCE_TYPEобязательная- Тип экземпляра: single или cluster
VM_INSTANCE_BEARER_TOKENобязательная, секрет- Токен для API VictoriaMetrics
VMC_API_KEYсекрет- Ключ API VictoriaMetrics Cloud
Ограничения
Нужен адрес экземпляра VictoriaMetrics в `VM_INSTANCE_ENTRYPOINT`, тип одиночный или кластерный в `VM_INSTANCE_TYPE` и токен в `VM_INSTANCE_BEARER_TOKEN`, а для облака ключ `VMC_API_KEY`. Часть инструментов (`export`, отладчики релейблинга и даунсэмплинга, `test_rules`, `flags`) по умолчанию отключена, их включают отдельно, а лишние отключают в `MCP_DISABLED_TOOLS`. Крупные ответы режутся по `MCP_MAX_RESPONSE_SIZE`. В режимах SSE и HTTP без `MCP_AUTH_TOKEN` порт остается без защиты. Качество ответов зависит от клиента и модели.
Как отключить. Удалите блок victoriametrics из конфигурации клиента (`claude mcp remove victoriametrics`), отзовите токен и остановите контейнер, если запускали сетевой режим.
Частые вопросы
Как попробовать сервер без установки?
В README есть публичный экземпляр `https://play-mcp.victoriametrics.com/mcp`, настроенный на публичную площадку VictoriaMetrics Playground. Адрес предназначен для MCP-клиентов, а не для браузера.
Как подключить сервер к Claude Code?
Локальный бинарник: `claude mcp add victoriametrics -e VM_INSTANCE_ENTRYPOINT=<адрес> -e VM_INSTANCE_TYPE=<тип> -e VM_INSTANCE_BEARER_TOKEN=<токен> -- /path/to/mcp-victoriametrics`. Для сервера в режиме HTTP: `claude mcp add victoriametrics --transport http http://localhost:8080/mcp`.
Какие данные видит агент?
Метрики, метки, серии, правила, алерты, параметры экземпляра, статистику кардинальности и топ запросов. Инструменты экспорта и отладки включаются отдельно.
Как работает режим кластера?
Задайте `VM_INSTANCE_TYPE` как cluster и при необходимости `VM_DEFAULT_TENANT_ID` в формате `accountID` или `accountID:projectID`. Инструмент `tenants` перечисляет арендаторов.
Как защитить сетевой режим?
Задайте `MCP_AUTH_TOKEN`: он действует в режимах `sse` и `http`, пути здоровья и метрик остаются публичными. Дополнительно ограничьте доступ на уровне сети.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер VictoriaLogs: агент выполняет запросы LogsQL, смотрит потоки и поля и ищет по встроенной документации.
VictoriaMetrics skills — метрики, логи и трейсы
VictoriaMetrics skills
Четырнадцать скиллов VictoriaMetrics: PromQL и LogsQL, трейсы, кардинальность, аномалии и поиск флагов в документации
MCP-сервер для Prometheus: агент выполняет PromQL-запросы, ищет метрики и проверяет цели сбора
Официальный MCP-сервер Prometheus: PromQL-запросы, метрики, правила и оповещения плюс встроенные runbook для разбора проблем.
Datadog MCP Server (winor30)
Datadog MCP Server
Независимый MCP-сервер Datadog: агент читает инциденты, мониторы, логи, метрики, трейсы и RUM и планирует простои.
MCP PostgreSQL Ops выбирает метрики под версию PostgreSQL: администратор получает показатели, которые доступны его установке.
Коротко о README
Текст представляет сервер как интерфейс мониторинга и отладки для VictoriaMetrics, перечисляет возможности и дает публичный экземпляр для пробы. Дальше идут требования, установка из релиза, Docker и Helm, переменные окружения, режимы, подключение к Claude Desktop, Claude Code и другим клиентам, таблицы инструментов и промптов.