Skip to main content
Glama
VictoriaMetrics-mcp-server

VictoriaMetrics-mcp-server

Сервер MCP VictoriaMetrics

значок кузнеца

Сервер MCP для VictoriaMetrics.

Установка через Smithery

Чтобы автоматически установить VictoriaMetrics Server для Claude Desktop через Smithery :

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

Отлаживать

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

НПХ

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

📊 Документация API инструментов VictoriaMetrics

Related MCP server: ClickHouse MCP Server

1. vm_data_write

Описание : Запись данных в базу данных VictoriaMetrics.

Входные параметры :

Параметр

Тип

Описание

Необходимый

metric

object

Теги метрики

✅

values

number[]

Массив значений метрик

✅

timestamps

number[]

Массив временных меток в секундах Unix

✅


2. vm_prometheus_write

Описание : Импорт данных формата экспозиции Prometheus в VictoriaMetrics.

Входные параметры :

Параметр

Тип

Описание

Необходимый

data

string

Метрики в формате описания Prometheus

✅


3. vm_query_range

Описание : Запрос данных временного ряда за определенный временной диапазон.

Входные параметры :

Параметр

Тип

Описание

Необходимый

query

string

Выражение PromQL

✅

start

number

Начальная временная метка в секундах Unix

⛔️

end

number

Конечная временная метка в секундах Unix

⛔️

step

string

Ширина шага разрешения запроса (например, 10s , 1m )

⛔️

Обязателен только query ; остальные поля необязательны.


4. vm_query

Описание : Запрос текущего значения временного ряда.

Входные параметры :

Параметр

Тип

Описание

Необходимый

query

string

Выражение PromQL для оценки

✅

time

number

Временная метка оценки в секундах Unix

⛔️


5. vm_labels

Описание : Получить все уникальные названия меток.

Входные параметры : нет


6. vm_label_values

Описание : Получить все уникальные значения для определенной метки.

Входные параметры :

Параметр

Тип

Описание

Необходимый

label

string

Имя метки для получения значений

✅


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