# mcp-victorialogs

Даёт агенту доступ к вашему инстансу VictoriaLogs: запросы по логам, список потоков и полей, статистика. Плюс встроенная документация, которую можно искать офлайн.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 105
- Автор: VictoriaMetrics
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/VictoriaMetrics/mcp-victorialogs
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/mcp/victoriametrics-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`.

## Требования
- Нужно: Docker
- Переменные окружения: `VL_INSTANCE_ENTRYPOINT`, `VL_INSTANCE_BEARER_TOKEN`, `MCP_DISABLED_TOOLS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- посмотреть, что происходит в логах, не открывая Web UI
- найти нужный поток и его поля по имени
- построить статистику по логам как по метрикам
- уточнить синтаксис запроса по встроенной документации
- проверить параметры инстанса VictoriaLogs

## Примеры запросов агенту
- Покажи последние ошибки из потока `nginx` за сегодня
- Какие поля есть у потока `app-logs`?
- Собери статистику по количеству записей в разрезе уровня логирования

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md