Для чего этот сервер?

Этот MCP-сервер даёт AI-ассистентам прямой доступ к логам в VictoriaLogs — искать записи, считать статистику, смотреть поля и стримы. Он решает одну задачу: позволяет инженерам разбираться с инцидентами и отладкой прямо из чата или IDE, не переключаясь в веб-интерфейс. Внутри ещё есть встроенная документация, так что AI может подсмотреть, как устроен тот или иной запрос, даже без интернета.

Каталог MCP
VictoriaMetrics-Community/mcp-victorialogs

VictoriaMetrics-Community/mcp-victorialogs

от victoriametrics-community

MCP-сервер для VictoriaLogs. Предоставляет AI-агентам доступ к чтению логов, метрик, полей и встроенной документации через LogsQL-запросы. Упрощает отладку и мониторинг для инженеров.

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

VictoriaLogs MCP Server

License

The implementation of Model Context Protocol (MCP) server for VictoriaLogs.

This provides access to your VictoriaLogs instance and seamless integration with VictoriaLogs APIs and documentation. It can give you a comprehensive interface for logs, observability, and debugging tasks related to your VictoriaLogs instances, enable advanced automation and interaction capabilities for engineers and tools.

Features

This MCP server allows you to use almost all read-only APIs of VictoriaLogs, i.e. all functions available in Web UI:

Querying logs and exploring logs data
Showing parameters of your VictoriaLogs instance
Listing available streams, fields, field values
Query statistics for the logs as metrics
UI with setup instructions and tools inspection on the root endpoint (only in Streamable HTTP mode)

In addition, the MCP server contains embedded up-to-date documentation and is able to search it without online access.

More details about the exact available tools and prompts can be found in the Usage section.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить VictoriaMetrics-Community/mcp-victorialogs:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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>"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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>"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"victoriametrics-community-mcp-victorialo-7tgb20jwdt\",\"type\":\"stdio\",\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"-e\",\"VL_INSTANCE_ENTRYPOINT\",\"-e\",\"VL_INSTANCE_BEARER_TOKEN\",\"-e\",\"VL_INSTANCE_HEADERS\",\"ghcr.io/victoriametrics/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>\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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>"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add victoriametrics-community-mcp-victorialo-7tgb20jwdt --env VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> --env VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN> --env VL_INSTANCE_HEADERS=<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE> -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e VL_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victorialogs

Либо через JSON-конфиг:

claude mcp add-json victoriametrics-community-mcp-victorialo-7tgb20jwdt "{\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"-e\",\"VL_INSTANCE_ENTRYPOINT\",\"-e\",\"VL_INSTANCE_BEARER_TOKEN\",\"-e\",\"VL_INSTANCE_HEADERS\",\"ghcr.io/victoriametrics/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>\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add victoriametrics-community-mcp-victorialo-7tgb20jwdt --env VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> --env VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN> --env VL_INSTANCE_HEADERS=<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE> -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e VL_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victorialogs

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.victoriametrics-community-mcp-victorialo-7tgb20jwdt]
command = "docker"
args = ["run", "-i", "--rm", "-e", "VL_INSTANCE_ENTRYPOINT", "-e", "VL_INSTANCE_BEARER_TOKEN", "-e", "VL_INSTANCE_HEADERS", "ghcr.io/victoriametrics/mcp-victorialogs"]

[mcp_servers.victoriametrics-community-mcp-victorialo-7tgb20jwdt.env]
VL_INSTANCE_ENTRYPOINT = "<YOUR_VL_INSTANCE>"
VL_INSTANCE_BEARER_TOKEN = "<YOUR_VL_BEARER_TOKEN>"
VL_INSTANCE_HEADERS = "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите VictoriaMetrics-Community/mcp-victorialogs, а в поле команды запуска — строку ниже:

docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e VL_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victorialogs

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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>"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например victoriametrics-community-mcp-victorialo-7tgb20jwdt.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: victoriametrics-community-mcp-victorialo-7tgb20jwdt
    command: docker
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "VL_INSTANCE_ENTRYPOINT"
      - "-e"
      - "VL_INSTANCE_BEARER_TOKEN"
      - "-e"
      - "VL_INSTANCE_HEADERS"
      - "ghcr.io/victoriametrics/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>

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "victoriametrics-community-mcp-victorialo-7tgb20jwdt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "-e",
        "VL_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/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>"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "VL_INSTANCE_ENTRYPOINT",
    "-e",
    "VL_INSTANCE_BEARER_TOKEN",
    "-e",
    "VL_INSTANCE_HEADERS",
    "ghcr.io/victoriametrics/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>"
  }
}