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.
Входные параметры :
Параметр | Тип | Описание | Необходимый |
|
| Теги метрики | ✅ |
|
| Массив значений метрик | ✅ |
|
| Массив временных меток в секундах Unix | ✅ |
2. vm_prometheus_write
Описание : Импорт данных формата экспозиции Prometheus в VictoriaMetrics.
Входные параметры :
Параметр | Тип | Описание | Необходимый |
|
| Метрики в формате описания Prometheus | ✅ |
3. vm_query_range
Описание : Запрос данных временного ряда за определенный временной диапазон.
Входные параметры :
Параметр | Тип | Описание | Необходимый |
|
| Выражение PromQL | ✅ |
|
| Начальная временная метка в секундах Unix | ⛔️ |
|
| Конечная временная метка в секундах Unix | ⛔️ |
|
| Ширина шага разрешения запроса (например, | ⛔️ |
Обязателен только
query; остальные поля необязательны.
4. vm_query
Описание : Запрос текущего значения временного ряда.
Входные параметры :
Параметр | Тип | Описание | Необходимый |
|
| Выражение PromQL для оценки | ✅ |
|
| Временная метка оценки в секундах Unix | ⛔️ |
5. vm_labels
Описание : Получить все уникальные названия меток.
Входные параметры : нет
6. vm_label_values
Описание : Получить все уникальные значения для определенной метки.
Входные параметры :
Параметр | Тип | Описание | Необходимый |
|
| Имя метки для получения значений | ✅ |
Available Tools
6 toolsvm_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
Scored across 6 tools
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).
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.
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.
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
Related MCP Connectors
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for interacting with Prometheus metrics and data.17MIT
- Apache 2.0
- AlicenseNot gradedqualityBmaintenanceThe implementation of Model Context Protocol (MCP) server for VictoriaMetrics247Apache 2.0
- AlicenseNot gradedqualityBmaintenanceThe implementation of Model Context Protocol (MCP) server for VictoriaLogs.112Apache 2.0