mcp-victorialogs

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

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

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

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

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

Только чтение логов VictoriaLogs через API с токеном; данные не изменяет.

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

codex
{
    "code": "[mcp_servers.victorialogs]\ncommand = \"/path/to/mcp-victorialogs\"\n\n[mcp_servers.victorialogs.env]\nVL_INSTANCE_ENTRYPOINT = \"<YOUR_VL_INSTANCE>\"\nVL_INSTANCE_BEARER_TOKEN = \"<YOUR_VL_BEARER_TOKEN>\"\nVL_INSTANCE_HEADERS = \"<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>\"",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

VictoriaLogs MCP Server — официальный MCP-сервер VictoriaMetrics для VictoriaLogs, базы данных логов. Он даёт ассистенту доступ к вашему экземпляру VictoriaLogs, его API и документации — для работы с логами, наблюдаемостью и отладкой.

Сервер открывает почти все API VictoriaLogs только для чтения, то есть всё, что доступно в веб-интерфейсе:

  • query — выполнение запросов LogsQL;
  • hits — число подходящих записей, сгруппированное по интервалам;
  • stats_query и stats_query_range — статистика по логам как метрики на момент или за период;
  • facets — самые частые значения каждого поля;
  • field_names, field_values — поля и их значения для запроса;
  • streams, stream_ids, stream_field_names, stream_field_values — потоки и их поля;
  • flags — нестандартные флаги экземпляра;
  • documentation — поиск по встроенной актуальной документации VictoriaLogs без доступа в интернет.

В режиме Streamable HTTP на корневом адресе открывается страница с инструкциями по настройке и просмотром инструментов. Ненужные инструменты отключаются переменной MCP_DISABLED_TOOLS. Сервер поддерживает три транспорта: stdio (по умолчанию), SSE и Streamable HTTP; в сетевых режимах есть эндпоинты метрик Prometheus и проверки здоровья.

Попробовать без установки можно на публичном экземпляре https://play-vmlogs-mcp.victoriametrics.com/mcp, подключённом к публичной песочнице VictoriaLogs (этот адрес предназначен для MCP-клиентов, а не для браузера).

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

  • SRE и DevOps-инженерам, разбирающим инциденты по логам.
  • Разработчикам, которые ищут ошибки в логах своих сервисов.
  • Командам на стеке VictoriaMetrics, которым нужен ассистент со знанием LogsQL.

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

Установка

Нужен экземпляр VictoriaLogs (одиночный или кластер). Установите сервер через Go (go install github.com/VictoriaMetrics/mcp-victorialogs/cmd/mcp-victorialogs@latest, Go 1.26+), скачайте готовый бинарник со страницы релизов, запустите Docker-образ ghcr.io/victoriametrics/mcp-victorialogs или Helm-чарт. Основные переменные: VL_INSTANCE_ENTRYPOINT (адрес VictoriaLogs), VL_INSTANCE_BEARER_TOKEN (токен API), VL_INSTANCE_HEADERS (свои заголовки), VL_DEFAULT_TENANT_ID и MCP_SERVER_MODE.

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

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>",
        "VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

Пути к файлам: Cursor — ~/.cursor/mcp.json, Claude Desktop — claude_desktop_config.json (тот же JSON, что для Cursor), Codex — ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Замените заполнители на адрес своего экземпляра и токен.

Проверка

Спросите: «Какие потоки логов есть за последний час?» — сработает streams.

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

Найди ошибки уровня error за последние 15 минут и сгруппируй их по сервису.
Покажи, как менялось число записей с кодом 500 за сутки, и объясни всплески.

Риски

  • Доступ к логам. Логи могут содержать персональные данные и секреты; ассистент увидит всё, что разрешает токен.
  • Только чтение. Сервер использует API чтения и не изменяет данные VictoriaLogs.
  • Сетевые режимы. В SSE и HTTP сервер открывает порт; при пробросе заголовков следите, какие из них уходят в VictoriaLogs.

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

Может ли сервер удалить логи?

Нет, доступны только API чтения.

Можно ли попробовать без своей установки?

Да, через публичный экземпляр, подключённый к песочнице VictoriaLogs.

Как отключить часть инструментов?

Переменной MCP_DISABLED_TOOLS, например hits,facets.

Основы протокола — на странице что такое 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

Источники