Victorialogs MCP Server

by victoriametrics-communityio.github.VictoriaMetrics-Community/mcp-victorialogsv1.8.0

Integration with VictoriaLogs APIs and documentation for working with logs and debugging VictoriaLogs instances.

99Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Victorialogs MCP server

claude mcp add victorialogs -e VL_INSTANCE_ENTRYPOINT='<vl-instance-entrypoint>' -e 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

{
  "mcpServers": {
    "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 (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VL_INSTANCE_ENTRYPOINT	yes	—	URL to VictoriaMetrics instance (it should be root URL of vmlingle or vlselect), for example http://localhost:9428 or https://play-vmlogs.victoriametrics.com
VL_INSTANCE_BEARER_TOKEN	yes	yes	Authentication token for VictoriaMetrics API
MCP_DISABLED_TOOLS	—	—	Comma-separated list of tools to disable

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-04-10 · 6mo ago · GitHub · v1.9.0
Package published
no data · npm/PyPI
Registry entry updated
2025-12-15 · 10mo ago · official registry · v1.8.0

FAQ

›How do I install the Victorialogs MCP server in Claude Code?

Run: claude mcp add victorialogs -e VL_INSTANCE_ENTRYPOINT='<vl-instance-entrypoint>' -e 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. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Victorialogs require an API key?

Yes. It expects VL_INSTANCE_ENTRYPOINT, VL_INSTANCE_BEARER_TOKEN, of which 1 is a secret.

›Can I use Victorialogs as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Victorialogs in the official MCP registry?

Yes, as io.github.VictoriaMetrics-Community/mcp-victorialogs.