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