mcp-victorialogs
Официальный MCP-сервер VictoriaLogs: агент выполняет запросы LogsQL, смотрит потоки и поля и ищет по встроенной документации.
- 111 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Содержимое логов, включая секреты и персональные данные в них, попадает в контекст модели.
- Токен доступа к VictoriaLogs лежит в конфигурации клиента.
Установка
- Работает в
Ручная установка
go install github.com/VictoriaMetrics/mcp-victorialogs/cmd/mcp-victorialogs@latestПервый вариант из README. Есть также бинарные релизы, образ Docker и чарт Helm.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Содержимое логов, включая секреты и персональные данные в них, попадает в контекст модели.
- Токен доступа к VictoriaLogs лежит в конфигурации клиента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер подключает агента к уже работающему VictoriaLogs, одиночному или кластерному. Агент выполняет запросы `query` на LogsQL, считает попадания по интервалам (`hits`), получает статистику, перечисляет потоки, поля и их значения. Доступны почти все API только для чтения, которые есть в веб-интерфейсе. В сервер встроена актуальная документация VictoriaLogs, и `documentation` ищет по ней без выхода в сеть. Режимы работы: `stdio` по умолчанию, `sse` и потоковый `http`. В HTTP-режиме корневая страница показывает инструкцию подключения и список инструментов, а ненужные инструменты отключаются переменной `MCP_DISABLED_TOOLS`.
Для кого. SRE и разработчикам, у которых логи лежат в VictoriaLogs, а разбор инцидентов идет вместе с агентом.
Подходит, если
- Ночью сработал алерт, и агент ищет ошибки сервиса за последний час.
- Разработчик не помнит синтаксис LogsQL и просит составить запрос.
- У незнакомого приложения нужно выяснить, какие потоки и поля есть в логах.
- Команда поднимает общий MCP по HTTP для нескольких клиентов.
Не подходит, если
- Логи хранятся в другой системе, например в Loki или Elasticsearch.
- Агенту нужно менять данные или настройки VictoriaLogs.
- В логах лежат персональные данные, которые нельзя показывать модели.
Пример запроса к агенту
Найди в логах сервиса `checkout` ошибки за последний час, сгруппируй их по тексту и покажи три самые частые.MCP
- Транспорт
- stdio, sse, http
- Авторизация
- ключ необязателен
Переменные окружения
VL_INSTANCE_ENTRYPOINTобязательная- Адрес экземпляра VictoriaLogs
VL_INSTANCE_BEARER_TOKENсекрет- Токен доступа к API VictoriaLogs, если нужен
Ограничения
Сервер только читает и работает с уже развернутым VictoriaLogs: адрес задает `VL_INSTANCE_ENTRYPOINT`, токен доступа — `VL_INSTANCE_BEARER_TOKEN`. Содержимое найденных логов попадает в контекст модели вместе со всеми секретами и персональными данными, которые в них оказались. Качество ответов зависит от клиента и модели, а не только от сервера. Для сборки из исходников нужен Go 1.26 или новее. Публичный стенд из README подходит для пробы, рабочие логи к нему не подключают.
Как отключить. Удалите запись сервера из конфигурации клиента и остановите контейнер или процесс, если запускали их сами. Выданный токен доступа к VictoriaLogs отзовите отдельно.
Частые вопросы
Какие инструменты есть в сервере?
Доступны `query`, `hits`, `stats_query`, `stats_query_range`, `field_names`, `field_values`, `streams`, `stream_ids`, `facets`, `flags` и `documentation`. Инструментов записи нет.
Можно ли попробовать без установки?
Да, README дает публичный адрес `https://play-vmlogs-mcp.victoriametrics.com/mcp` для тестового стенда. Адрес вставляют в MCP-клиент, в браузере он не открывается.
Как отключить лишние инструменты?
Перечислите их через запятую в `MCP_DISABLED_TOOLS`, например `hits,facets`, и перезапустите сервер.
Нужен ли токен?
Только если VictoriaLogs закрыт авторизацией. Токен задает `VL_INSTANCE_BEARER_TOKEN`, произвольные заголовки — `VL_INSTANCE_HEADERS`.
Подойдет ли кластерная версия?
Да, сервер работает и с одиночным, и с кластерным VictoriaLogs. Арендатор по умолчанию задает `VL_DEFAULT_TENANT_ID` в формате `AccountID:ProjectID`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер VictoriaMetrics: запросы метрик, правила и алерты, кардинальность и встроенная документация для агента
Агент ищет в журналах AWS CloudWatch, суммирует активность и сопоставляет события из разных сервисов.
VictoriaMetrics skills — метрики, логи и трейсы
VictoriaMetrics skills
Четырнадцать скиллов VictoriaMetrics: PromQL и LogsQL, трейсы, кардинальность, аномалии и поиск флагов в документации
Datadog MCP Server (winor30)
Datadog MCP Server
Независимый MCP-сервер Datadog: агент читает инциденты, мониторы, логи, метрики, трейсы и RUM и планирует простои.
Официальный управляемый MCP-сервер Datadog: логи, метрики, трейсы и инциденты прямо в агенте
Встроенный MCP OneUptime: агент разбирает инциденты, читает логи и трассы, подтверждает алерты и настраивает мониторы.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-victorialogs (эта карточка) | да | ключ необязателен | 111 | |
| Grafana MCP Server | да | API-ключ | 3 663 | работает с дашбордами и источниками данных Grafana; этот сервер читает логи VictoriaLogs запросами LogsQL |
| VictoriaMetrics skills — метрики, логи и трейсы | да | 63 | набор скиллов про метрики VictoriaMetrics; здесь MCP-сервер для логов |
Коротко о README
Три режима работы: `stdio`, `sse` и потоковый `http`. В HTTP-режиме есть метрики Prometheus на `/metrics` и проверки `/health/liveness` и `/health/readiness`.