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 в переменных окружения.
Настройка клиентов
{
"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
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.