Victorialogs

Name: Victorialogs
Author: VictoriaMetrics-Community

@VictoriaMetrics-Community

Repository

About Victorialogs

No overview available yet

#victorialogs #mcp-server #observability

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Victorialogs?

Victorialogs is an MCP (Model Context Protocol) server that provides access to your VictoriaLogs instance and its read‑only APIs, along with embedded up‑to‑date documentation. It is designed for engineers working with logs, observability, and debugging tasks.

How to use Victorialogs?

Install via Go, from source, or download a binary release. Set the required environment variable VL_INSTANCE_ENTRYPOINT (and optionally VL_INSTANCE_BEARER_TOKEN), then configure the server in your MCP client (e.g., Cursor, Claude Desktop, VS Code). After configuration, start asking questions – the assistant will automatically use the tools and documentation.

Key features of Victorialogs

Query logs and explore log data using LogsQL.
Show parameters and non‑default flags of your VictoriaLogs instance.
List available streams, fields, and field values.
Query log statistics as metrics for given time ranges.
Search embedded VictoriaLogs documentation without online access.

Use cases of Victorialogs

Debugging production issues by querying logs directly from an AI assistant.
Automating observability tasks across multiple VictoriaLogs instances.
Combining log queries with documentation searches for troubleshooting.
Enabling non‑GUI log analysis for CLI‑focused workflows.

FAQ from Victorialogs

What are the requirements to run Victorialogs?

You need a running VictoriaLogs instance (single‑node or cluster). To build from source, Go 1.24 or higher is required; prebuilt binaries are also available.

How do I authenticate to my VictoriaLogs instance?

Set the VL_INSTANCE_BEARER_TOKEN environment variable. This token is passed to the VictoriaLogs API for authentication.

What transports does Victorialogs support?

The server supports both stdio (default) and sse (Server‑Sent Events) modes, configurable via MCP_SERVER_MODE.

Is documentation search available offline?

Yes. The server contains an embedded copy of VictoriaLogs documentation and can search it without internet access.

What APIs does Victorialogs expose?

It provides read‑only tools – queries, stats, field/stream listings, flags, and documentation search – mirroring the functions available in the VictoriaLogs Web UI.