mcp-victorialogs — MCP-сервер для Claude Code: доступ к логам
Даёт агенту доступ к вашему инстансу VictoriaLogs: запросы по логам, список потоков и полей, статистика. Плюс встроенная документация, которую можно искать офлайн.
claude mcp add --env VL_INSTANCE_ENTRYPOINT=<VL_INSTANCE_ENTRYPOINT> --env VL_INSTANCE_BEARER_TOKEN=<VL_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio victoriametrics-mcp-victorialogs -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victorialogs:1.9.0Что делает mcp-victorialogs
Сервер открывает почти все read-only API VictoriaLogs — те же возможности, что и в Web UI. Можно исследовать логи, смотреть параметры инстанса, перечислять доступные потоки, поля и их значения, строить статистику по логам как по метрикам. В Streamable HTTP режиме на корневом эндпоинте есть UI с инструкциями по настройке и списком инструментов.
Документация VictoriaLogs вшита внутрь, поэтому поиск по ней работает без выхода в сеть. Ставить можно через Go, готовые бинарники, Docker или Helm-чарт. Для сборки из исходников нужен Go 1.26 или новее. Без работающего инстанса VictoriaLogs серверу нечего читать — сначала поднимите single-node или cluster.
Есть публичный инстанс https://play-vmlogs-mcp.victoriametrics.com/mcp для теста без установки. Он работает в Streamable HTTP режиме и смотрит на публичный playground VictoriaLogs. Открывать этот адрес в браузере не нужно: он предназначен для MCP-клиентов. Настройка идёт через переменные окружения VL_INSTANCE_ENTRYPOINT, VL_INSTANCE_BEARER_TOKEN и MCP_DISABLED_TOOLS.
Какие задачи решает
- посмотреть, что происходит в логах, не открывая Web UI
- найти нужный поток и его поля по имени
- построить статистику по логам как по метрикам
- уточнить синтаксис запроса по встроенной документации
- проверить параметры инстанса VictoriaLogs
Примеры запросов агенту
- Покажи последние ошибки из потока
nginxза сегодня - Какие поля есть у потока
app-logs? - Собери статистику по количеству записей в разрезе уровня логирования
Как установить mcp-victorialogs
Командой платформы
claude mcp add --env VL_INSTANCE_ENTRYPOINT=<VL_INSTANCE_ENTRYPOINT> --env VL_INSTANCE_BEARER_TOKEN=<VL_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio victoriametrics-mcp-victorialogs -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victorialogs:1.9.0Вместо <…> подставьте свои значения
Командой платформы
codex mcp add victoriametrics-mcp-victorialogs --env VL_INSTANCE_ENTRYPOINT=<VL_INSTANCE_ENTRYPOINT> --env VL_INSTANCE_BEARER_TOKEN=<VL_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victorialogs:1.9.0Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"victoriametrics-mcp-victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"MCP_DISABLED_TOOLS",
"ghcr.io/victoriametrics/mcp-victorialogs:1.9.0"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
"VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>",
"MCP_DISABLED_TOOLS": "<MCP_DISABLED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"victoriametrics-mcp-victorialogs": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"MCP_DISABLED_TOOLS",
"ghcr.io/victoriametrics/mcp-victorialogs:1.9.0"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
"VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>",
"MCP_DISABLED_TOOLS": "<MCP_DISABLED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e VL_INSTANCE_ENTRYPOINT=<VL_INSTANCE_ENTRYPOINT> -e VL_INSTANCE_BEARER_TOKEN=<VL_INSTANCE_BEARER_TOKEN> -e MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> victoriametrics-mcp-victorialogs docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victorialogs:1.9.0Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-victorialogs
Как установить mcp-victorialogs в Claude Code?
Одной командой: `claude mcp add --env VL_INSTANCE_ENTRYPOINT=<VL_INSTANCE_ENTRYPOINT> --env VL_INSTANCE_BEARER_TOKEN=<VL_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio victoriametrics-mcp-victorialogs -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victorialogs:1.9.0`. Подставьте адрес своего инстанса и токен.
Что делает mcp-victorialogs?
Подключает агента к API VictoriaLogs: запросы по логам, список потоков и полей, статистика. Ещё даёт поиск по встроенной документации без доступа к сети.
Можно ли попробовать без установки?
Да, есть публичный инстанс https://play-vmlogs-mcp.victoriametrics.com/mcp в режиме Streamable HTTP. Он подключён к публичному playground VictoriaLogs, так что свои данные там не появятся.
