AI导哈

VictoriaMetrics 时序数据写入与查询 MCP 服务

为 VictoriaMetrics 时序数据库提供 MCP 接入服务，支持数据写入、Prometheus 格式导入、PromQL 范围查询与即时查询，以及标签和标签值获取，适用于监控指标管理和时序数据分析场景。

  • by yincongcyincong
  • JavaScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 yincongcyincong/VictoriaMetrics-mcp-server

使用说明

VictoriaMetrics 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:

Parameter Type Description Required
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:

Parameter Type Description Required
data string Metrics in Prometheus exposition format ✅

3. vm_query_range

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

Input Parameters:

Parameter Type Description Required
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:

Parameter Type Description Required
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:

Parameter Type Description Required
label string Label name to get values for ✅

相关 MCP