Skip to content
MCP server

MCP Victorialogs

MCP Server for VictoriaLogs. Provides integration with VictoriaLogs API and documentation

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.8.0
Listing updated
4 days ago

About MCP Victorialogs

MCP Victorialogs is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-victorialogs --env VL_INSTANCE_ENTRYPOINT='<VL_INSTANCE_ENTRYPOINT>' --env VL_INSTANCE_BEARER_TOKEN='<VL_INSTANCE_BEARER_TOKEN>' -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0"
      ],
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
        "VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0"
      ],
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
        "VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-victorialogs": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0"
      ],
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
        "VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0"
      ],
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
        "VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VL_INSTANCE_ENTRYPOINT",
        "-e",
        "VL_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0"
      ],
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<VL_INSTANCE_ENTRYPOINT>",
        "VL_INSTANCE_BEARER_TOKEN": "<VL_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Configuration

  • VL_INSTANCE_ENTRYPOINTURL to VictoriaMetrics instance (it should be root URL of vmlingle or vlselect), for example http://localhost:9428 or https://play-vmlogs.victoriametrics.comRequired
  • VL_INSTANCE_BEARER_TOKENAuthentication token for VictoriaMetrics APIRequired
  • MCP_DISABLED_TOOLSComma-separated list of tools to disable

Pricing

Open source

MCP Victorialogs FAQ

Is MCP Victorialogs free?

Yes. MCP Victorialogs is open source, so you can use and self-host it for free.

How do I add MCP Victorialogs to Claude Code?

Run this command in your terminal: claude mcp add mcp-victorialogs --env VL_INSTANCE_ENTRYPOINT='<VL_INSTANCE_ENTRYPOINT>' --env VL_INSTANCE_BEARER_TOKEN='<VL_INSTANCE_BEARER_TOKEN>' -- docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0