Labsco
yincongcyincong logo

VictoriaMetrics

โ˜… 7

from yincongcyincong

A server for writing and querying time series data using the VictoriaMetrics API.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup

MseeP.ai Security Assessment Badge

VictoriaMetrics MCP Server

smithery badge

VictoriaMetrics-mcp-server MCP server

MCP Server for the VictoriaMetrics.

Installing via Smithery

To install VictoriaMetrics Server for Claude Desktop automatically via Smithery:

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

Debug

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

NPX

{
    "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
metricobjectTags of the metricโœ…
valuesnumber[]Array of metric valuesโœ…
timestampsnumber[]Array of timestamps in Unix secondsโœ…

2. vm_prometheus_write

Description: Import Prometheus exposition format data into VictoriaMetrics.

Input Parameters:

ParameterTypeDescriptionRequired
datastringMetrics in Prometheus exposition formatโœ…

3. vm_query_range

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

Input Parameters:

ParameterTypeDescriptionRequired
querystringPromQL expressionโœ…
startnumberStart timestamp in Unix secondsโ›”๏ธ
endnumberEnd timestamp in Unix secondsโ›”๏ธ
stepstringQuery 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
querystringPromQL expression to evaluateโœ…
timenumberEvaluation 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
labelstringLabel name to get values forโœ