Victoriametrics Mcp Server

Victoriametrics Mcp Server is an MCP server that connects large language model interfaces to VictoriaMetrics time series databases. Built for DevOps engineers, site reliability teams, and systems analysts, it enables LLM assistants to interact directly with monitoring and observability infrastructure. Through standard Model Context Protocol endpoints, users can write metric points, ingest data formatted for Prometheus exposition, and evaluate PromQL expressions across historical or instantaneous timeframes. It also provides introspection tools to discover metric label names and fetch associated label values directly from database instances. By integrating database read and write actions into conversational agents, teams can investigate production incidents, verify telemetry ingestion pipelines, and generate custom operational metrics on demand without switching context between dashboards and external command-line utilities.

Category: Databases & Data Stores

Tags: metrics, monitoring, promql, timeseries, victoriametrics

Visit Victoriametrics Mcp Server

How to install and configure Victoriametrics Mcp Server

1. Ensure you have Node.js and npx available on your system. 2. Open your client configuration file, such as Claude Desktop's claude_desktop_config.json. 3. Add the server entry under mcpServers using the package @yincongcyincong/victoriametrics-mcp-server: json { "mcpServers": { "victoriametrics": { "command": "npx", "args": [ "-y", "@yincongcyincong/victoriametrics-mcp-server" ], "env": { "VM_URL": "http://127.0.0.1:8428", "VM_SELECT_URL": "", "VM_INSERT_URL": "" } } } } 4. Alternatively, install automatically via Smithery by running npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude. 5. Restart your client application to load the server tools.

What you can do with Victoriametrics Mcp Server

• Evaluating instant PromQL queries to check real-time service health, resource utilization, and application status during troubleshooting sessions. - Querying metric ranges over custom start and end timestamps to graph or summarize historical operational performance. - Ingesting raw Prometheus exposition text directly into VictoriaMetrics to backfill metrics or test scraping pipelines. - Exploring cluster metadata by fetching all registered label names and inspecting specific label values across telemetry streams. - Writing custom time series points using metric tag maps, values, and Unix timestamps directly from workflow scripts.

Key facts

• Open Source
• https://github.com/yincongcyincong/VictoriaMetrics-mcp-server
• Databases & Data Stores, Monitoring & Observability
• metrics, monitoring, promql, timeseries, victoriametrics

Part of MCP Servers

How do I install Victoriametrics Mcp Server?

You can install it automatically for Claude Desktop using Smithery by running npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude. Alternatively, add the @yincongcyincong/victoriametrics-mcp-server npx package command along with your VM_URL environment variables directly to your MCP client configuration file.

What can Victoriametrics Mcp Server do?

The server exposes tools to write custom metric arrays, ingest Prometheus exposition data, and run instant or range PromQL queries. It also includes tools to list all unique label names and retrieve values for specific metric labels.

Which MCP clients work with Victoriametrics Mcp Server?

Any client supporting the Model Context Protocol can communicate with this server, including Claude Desktop and debugging utilities such as the Model Context Protocol Inspector.

Is Victoriametrics Mcp Server open source?

Yes, Victoriametrics Mcp Server is open-source software maintained by the community and accessible on GitHub.