Victoriametrics MCP Server

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

People who work with monitoring, observability and victoriametrics and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Go.

VERIFIED ACTIVE

LAST COMMIT 2026-08-23 · ★ 234 · #74 OF 120 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-09-18

Apache-2.0 · Go servers · how we verify → /methodology

01 · Install Victoriametrics

before you install - you'll need

Set VM_INSTANCE_HEADERS, MCP_PASSTHROUGH_HEADERS, MCP_DISABLED_TOOLS, VMC_API_KEY, MCP_SERVER_MODE, MCP_LISTEN_ADDR before connecting. VM_INSTANCE_ENTRYPOINT, VM_INSTANCE_TYPE, VM_INSTANCE_BEARER_TOKEN are optional or environment-specific per the README.

Docker

docker run -i --rm ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0

Claude Desktop - add to config

{
  "mcpServers": {
    "victoriametrics-community-mcp-victoriame": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0"
      ]
    }
  }
}
Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license Apache-2.0 - declared in the repository

registry namespace io.github.VictoriaMetrics-Community is GitHub-verified and matches the repo owner

03 · What Victoriametrics can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.20.2 · 2026-04-15

Bump github.com/mark3labs/mcp-go from 0.45.0 to 0.46.0 · Bump github.com/VictoriaMetrics/metricsql from 0.85.0 to 0.86.0 · Bump github.com/mark3labs/mcp-go from 0.46.0 to 0.47.0 · Bump…

v1.20.1 · 2026-03-19

add ability to override cloud base URL for testing purpose

v1.20.0 · 2026-03-18

support shared mode for cloud instances · Add simple UI for MCP server root with setup configs and tool inspection

04 · Who maintains Victoriametrics

mcp-victoriametrics is maintained by victoriametrics-community. We track 4 MCP servers from victoriametrics-community - 4 actively maintained, 356 combined GitHub stars, oldest repo from May 2025. Full record: all servers from victoriametrics-community.

  1. mcp-victorialogs MCP Server for VictoriaLogs. Provides integration with VictoriaLogs API and documentation ★ 98
  2. mcp-vmanomaly MCP Server for vmanomaly - VictoriaMetrics anomaly detection ★ 9
  3. mcp-victoriatraces MCP Server for VictoriaTraces. Provides integration with VictoriaTraces API and documentation ★ 15

05 · Facts

repository
github.com/victoriametrics-community/mcp-victoriametrics
category
DevOps & monitoring - ranked #74 of 120 actively-maintained DevOps & monitoring servers as of 2026-09-18.
registry
io.github.VictoriaMetrics-Community/mcp-victoriametrics (active, first published 2025-10-01 · 6 versions)
packages
oci:ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0

06 · Victoriametrics FAQ

What is Victoriametrics?

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

Is Victoriametrics still maintained?

Yes - as of 2026-09-18, its last commit was 2026-08-23. We re-verify nightly.

How do I install Victoriametrics?

Run `docker run -i --rm ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0`. The README documents 9 environment variables (VM_INSTANCE_ENTRYPOINT, VM_INSTANCE_TYPE, VM_INSTANCE_BEARER_TOKEN…) to set first. Set VM_INSTANCE_HEADERS, MCP_PASSTHROUGH_HEADERS, MCP_DISABLED_TOOLS, VMC_API_KEY, MCP_SERVER_MODE, MCP_LISTEN_ADDR before connecting. VM_INSTANCE_ENTRYPOINT, VM_INSTANCE_TYPE, VM_INSTANCE_BEARER_TOKEN are optional or environment-specific per the README. You can also paste the ready-made client config above.

07 · Alternatives to Victoriametrics

Alternatives to Victoriametrics

Maintained DevOps & monitoring servers if Victoriametrics isn't the fit.

  1. World Monitor Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 75 tools. ★ 86,725 · 2026-09-17
  2. Open Metadata Official OpenMetadata MCP: 21 read and write tools for search, lineage, data quality, governance. ★ 15,244 · 2026-09-18
  3. Kubeshark MCP Server Real-time Kubernetes network traffic visibility and API analysis for HTTP, gRPC, Redis, Kafka, DNS. ★ 12,082 · 2026-09-09
  4. Grafana An MCP server giving access to Grafana dashboards, data and more. ★ 3,467 · 2026-09-17
  5. Radar Kubernetes MCP Server Kubernetes MCP server for diagnosis, resource management, GitOps, and RBAC-enforced operations. ★ 3,371 · 2026-09-18
  6. Testkube MCP MCP server for Testkube - Manage test workflows, executions, and artifacts via AI assistants ★ 1,658 · 2026-09-18

Pairs well with

Servers that cover what Victoriametrics doesn't - only shown when the pairing reason fits the companion.

  1. Azure MCP Server → cloud infrastructure companion cloud infrastructure · ★ 3,681
  2. Kubernetes MCP Server → cloud infrastructure companion cloud infrastructure · ★ 2,104
  3. Agent Swarm → communication companion communication · ★ 806
  4. Agent Phone → communication companion communication · ★ 121

More DevOps & monitoring MCP servers · Victoriatraces · Vmanomaly · Cronicorn · Datto RMM · Ninja One

More Go MCP servers · Deja Vu · Vuln Check · Codex MCP Go · see all