trackmcp
Back to directory
yincongcyincong

victoriametrics-mcp-server

View on GitHub

MCP Server for the VictoriaMetrics.

7 stars JavaScriptServers & Infrastructure Updated Aug 8, 2025
mcpmcp-servermetricsvictoriametrics

Documentation

MseeP.ai Security Assessment Badge

VictoriaMetrics MCP Server

smithery badge

MCP Server for the VictoriaMetrics.

Installing via Smithery

To install VictoriaMetrics Server for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude

Debug

code
npx @modelcontextprotocol/inspector -e VM_URL=http://127.0.0.1:8428  node src/index.js

NPX

json
{
    "mcpServers": {
        "victoriametrics": {
            "command": "npx",
            "args": [
                "-y",
                "@yincongcyincong/victoriametrics-mcp-server"
            ],
            "env": {
                "VM_URL": "",
                "VM_SELECT_URL": "",
                "VM_INSERT_URL": ""
            }
        }
    }
}

๐Ÿ“Š VictoriaMetrics Tools API Documentation

1. `vm_data_write`

Description: Write data to the VictoriaMetrics database.

Input Parameters:

ParameterTypeDescriptionRequired
`metric``object`Tags of the metricโœ…
`values``number[]`Array of metric valuesโœ…
`timestamps``number[]`Array of timestamps in Unix secondsโœ…

2. `vm_prometheus_write`

Description: Import Prometheus exposition format data into VictoriaMetrics.

Input Parameters:

ParameterTypeDescriptionRequired
`data``string`Metrics in Prometheus exposition formatโœ…

3. `vm_query_range`

Description: Query time series data over a specific time range.

Input Parameters:

ParameterTypeDescriptionRequired
`query``string`PromQL expressionโœ…
`start``number`Start timestamp in Unix secondsโ›”๏ธ
`end``number`End timestamp in Unix secondsโ›”๏ธ
`step``string`Query resolution step width (e.g., `10s`, `1m`)โ›”๏ธ

> Only `query` is required; the other fields are optional.


4. `vm_query`

Description: Query the current value of a time series.

Input Parameters:

ParameterTypeDescriptionRequired
`query``string`PromQL expression to evaluateโœ…
`time``number`Evaluation timestamp in Unix secondsโ›”๏ธ

5. `vm_labels`

Description: Get all unique label names.

Input Parameters: None


6. `vm_label_values`

Description: Get all unique values for a specific label.

Input Parameters:

ParameterTypeDescriptionRequired
`label``string`Label name to get values forโœ…

Frequently asked questions

What is victoriametrics-mcp-server?

victoriametrics-mcp-server is MCP Server for the VictoriaMetrics.

How do I install victoriametrics-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is victoriametrics-mcp-server open source?

Yes โ€” it is hosted on GitHub at https://github.com/yincongcyincong/VictoriaMetrics-mcp-server and has 7 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP