Skip to main content
Glama
VictoriaMetrics-mcp-server

VictoriaMetrics-mcp-server

Servidor MCP de VictoriaMetrics

insignia de herrería

Servidor MCP para VictoriaMetrics.

Instalación mediante herrería

Para instalar VictoriaMetrics Server para Claude Desktop automáticamente a través de Smithery :

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

Depurar

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": ""
            }
        }
    }
}

Documentación de la API de herramientas de VictoriaMetrics

Related MCP server: ClickHouse MCP Server

1. vm_data_write

Descripción : Escribe datos en la base de datos VictoriaMetrics.

Parámetros de entrada :

Parámetro

Tipo

Descripción

Requerido

metric

object

Etiquetas de la métrica

✅

values

number[]

Matriz de valores métricos

✅

timestamps

number[]

Matriz de marcas de tiempo en segundos Unix

✅


2. vm_prometheus_write

Descripción : Importe datos en formato de exposición de Prometheus a VictoriaMetrics.

Parámetros de entrada :

Parámetro

Tipo

Descripción

Requerido

data

string

Métricas en formato de exposición de Prometeo

✅


3. vm_query_range

Descripción : Consulta datos de series temporales durante un rango de tiempo específico.

Parámetros de entrada :

Parámetro

Tipo

Descripción

Requerido

query

string

Expresión PromQL

✅

start

number

Marca de tiempo de inicio en segundos Unix

⛔️

end

number

Marca de tiempo final en segundos Unix

⛔️

step

string

Ancho del paso de resolución de la consulta (por ejemplo, 10s , 1m )

⛔️

Sólo se requiere query ; los demás campos son opcionales.


4. vm_query

Descripción : Consulta el valor actual de una serie temporal.

Parámetros de entrada :

Parámetro

Tipo

Descripción

Requerido

query

string

Expresión PromQL para evaluar

✅

time

number

Marca de tiempo de evaluación en segundos Unix

⛔️


5. vm_labels

Descripción : Obtenga todos los nombres de etiquetas únicos.

Parámetros de entrada : Ninguno


6. vm_label_values

Descripción : Obtenga todos los valores únicos para una etiqueta específica.

Parámetros de entrada :

Parámetro

Tipo

Descripción

Requerido

label

string

Nombre de la etiqueta para obtener valores

✅


Available Tools

6 tools
vm_data_writeC

Write data to the VM database

Inputs: metric (required), values (required), timestamps (required).

vm_labelsB

Get all unique label names

Inputs: no named parameters.

vm_label_valuesC

Get all unique values for a specific label

Inputs: label (required).

vm_prometheus_writeC

mport Prometheus exposition format data into VictoriaMetrics

Inputs: data (required).

vm_queryC

Query current value of a time series

Inputs: query (required), time.

vm_query_rangeC

Query time series over a time range

Inputs: query (required), start, end, step.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: writing data, retrieving metadata about labels, querying current values, and querying over time ranges. The descriptions make it easy to differentiate between tools like vm_query (current value) and vm_query_range (time range).

    Naming Consistency5/5

    All tools follow a consistent 'vm_' prefix with snake_case naming, using descriptive verb_noun patterns (e.g., vm_data_write, vm_query_range). There are no deviations in style or convention across the set.

    Tool Count5/5

    With 6 tools, this is well-scoped for a VictoriaMetrics server, covering core operations like data ingestion, label exploration, and querying without being overwhelming. Each tool earns its place in the workflow.

    Completeness4/5

    The toolset covers essential CRUD-like operations for time series data: writing (vm_data_write, vm_prometheus_write), reading (vm_query, vm_query_range), and metadata exploration (vm_labels, vm_label_values). A minor gap might be the lack of explicit deletion or update tools, but agents can work around this given the domain's typical usage patterns.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers