mcp-victoriametrics

mcp-victoriametrics — MCP-сервер сообщества (автор — VictoriaMetrics). Официальный сервер VictoriaMetrics: API и документация. Ставится через Docker. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
VictoriaMetrics
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
go

Уровень риска: medium

Только API чтения VictoriaMetrics; токен экземпляра или ключ Cloud в переменных окружения.

Настройка клиентов

codex
{
    "code": "codex mcp add victoriametrics \\\n  --env VM_INSTANCE_ENTRYPOINT=<YOUR_VM_INSTANCE> \\\n  --env VM_INSTANCE_TYPE=<YOUR_VM_INSTANCE_TYPE> \\\n  --env VM_INSTANCE_BEARER_TOKEN=<YOUR_VM_BEARER_TOKEN> \\\n  --env VM_INSTANCE_HEADERS=\"<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>\" \\\n  -- /path/to/mcp-victoriametrics",
    "lang": "sh",
    "notes": "Команда из README; конфиг ~/.codex/config.toml",
    "verified": "docs"
}

Что умеет

VictoriaMetrics MCP Server — официальный сервер для базы временных рядов VictoriaMetrics. Он открывает ИИ-ассистенту почти все API только для чтения — то же, что доступно в веб-интерфейсе VMUI:

  • запросы и исследование данных: мгновенные запросы и запросы за период, графики, если клиент умеет их рисовать;
  • метрики, метки и ряды: списки, значения меток, метаданные метрик, экспорт рядов;
  • правила и оповещения: просмотр правил записи и оповещений, текущих оповещений, модульные тесты правил;
  • параметры экземпляра и нестандартные флаги;
  • кардинальность и статистика: состояние TSDB, статистика использования метрик, активные и самые тяжёлые запросы;
  • работа с запросами: объяснение, форматирование и трассировка;
  • отладка правил перемаркировки, прореживания и хранения;
  • VictoriaMetrics Cloud: развёртывания, регионы, тарифы, токены доступа и файлы правил.

Во встроенной документации и статьях блога VictoriaMetrics сервер ищет без доступа к интернету. Готовые подсказки находят метрики, которые никто не запрашивает, и редко используемые метрики с высокой кардинальностью.

Кому подойдёт

  • Инженерам эксплуатации и SRE: вопросы о состоянии систем на естественном языке вместо ручного написания MetricsQL.
  • Администраторам VictoriaMetrics: поиск лишней кардинальности и неиспользуемых метрик.
  • Тем, кто изучает VictoriaMetrics: ответы по документации прямо в диалоге.

Похожие серверы — в категории облака и DevOps.

Установка

Нужен экземпляр VictoriaMetrics (одиночный или кластер) или VictoriaMetrics Cloud. Скачайте исполняемый файл со страницы релизов и поместите его в PATH; есть также образ Docker, Helm-чарт и сборка из исходников (Go 1.26+). Попробовать без установки можно на публичном сервере https://play-mcp.victoriametrics.com/mcp, подключённом к демо-стенду.

Подключение настраивается переменными окружения:

  • VM_INSTANCE_ENTRYPOINT — адрес экземпляра, VM_INSTANCE_TYPE — тип (single или cluster), VM_INSTANCE_BEARER_TOKEN — токен, если нужен;
  • VMC_API_KEY — ключ API для VictoriaMetrics Cloud;
  • MCP_DISABLED_TOOLS — список отключённых инструментов;
  • MCP_SERVER_MODE — транспорт: stdio (по умолчанию), sse или http; MCP_AUTH_TOKEN защищает сетевые режимы.

Храните токены в переменных окружения и не публикуйте их.

Подключение к клиентам

Конфиги приведены дословно из README. Замените значения-заглушки адресом и параметрами своего экземпляра, а путь — путём к скачанному файлу. Подробнее — в инструкции как подключить MCP.

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> \
  -e VM_INSTANCE_HEADERS="<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>" \
  -- /path/to/mcp-victoriametrics

Конфиг Cursor хранится в ~/.cursor/mcp.json, Claude Desktop — в claude_desktop_config.json, Codex — в ~/.codex/config.toml. В README также есть инструкции для VS Code, Zed, JetBrains, Windsurf, Gemini CLI и OpenCode, а для каждого клиента — вариант подключения к серверу в режиме Streamable HTTP.

Проверка

Начните диалог фразой «Use MCP VictoriaMetrics in the following answers» или просто спросите ассистента, какие метрики есть в базе. Он должен вызвать инструмент metrics и вернуть список имён.

Примеры задач

Какие метрики с высокой кардинальностью почти никто не запрашивает? Предложи, что можно отключить.
Объясни этот запрос MetricsQL и проверь, почему правило оповещения не срабатывает.

Риски

  • Доступ к данным мониторинга. Сервер использует API только для чтения, но агент видит все метрики, метки и правила экземпляра. Ненужные инструменты, например export или flags, можно оставить выключенными.
  • Токены. VM_INSTANCE_BEARER_TOKEN и VMC_API_KEY дают доступ к данным; храните их в секрете.
  • Сетевые режимы. В режимах sse и http задавайте MCP_AUTH_TOKEN. В режиме отладки журнал содержит запросы и ответы MCP.
  • Ресурсы. Встроенная векторная база документации потребляет память; её загрузку отключает documentation в MCP_DISABLED_TOOLS.
  • Точность. README напоминает, что результаты ИИ нужно перепроверять.

Частые вопросы

Может ли сервер изменить данные или настройки?

Нет. Сервер работает с API только для чтения.

Как подключить несколько экземпляров к одному серверу?

Через MCP_PASSTHROUGH_HEADERS и маршрутизацию по заголовкам в vmauth.

Почему сервер потребляет больше ресурсов, чем простой прокси?

Из-за встроенной векторной базы с документацией. Если поиск по документации не нужен, отключите инструмент documentation.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники