VictoriaLogs MCP Server

What it does

Connects AI agents to VictoriaLogs instances, allowing them to execute LogsQL queries, explore log data, and perform observability tasks directly through the Model Context Protocol.

Tools

• query: Execute LogsQL queries to retrieve log entries.
• documentation: Search embedded VictoriaLogs documentation for setup and usage help.
• facets: Retrieve most frequent values per log field.
• field_names: List available field names for a query.
• field_values: List values for specific fields.
• hits: Get the number of matching log entries grouped by buckets.
• stats_query: Query log statistics for a specific time.
• streams: List streams for the query.

Installation

Add the following to your claude_desktop_config.json:

{
  "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>"
      }
    }
  }
}

Supported hosts

Claude Desktop, Cursor, Claude Code, Codex, VS Code, Zed, Windsurf