MCP Server for the VictoriaMetrics.
{
"yincongcyincong-victoriametrics-mcp-server": {
"command": "npx",
"args": [
"-y",
"@yincongcyincong/victoriametrics-mcp-server"
],
"env": {
"VM_URL": "",
"VM_SELECT_URL": "",
"VM_INSERT_URL": ""
}
},
"yincongcyincong-victoriametrics-mcp-server-debug": {
"command": "node",
"args": [
"src/index.js"
],
"env": {
"VM_URL": "http://127.0.0.1:8428"
}
}
}
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
queryis 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 | ✅ |
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
queryis 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 | ✅ |
Related MCP Servers
Netdata
The fastest path to AI-powered full stack observability, even for lean teams.
mcp-grafana
MCP server for Grafana
prometheus-mcp-server
A Model Context Protocol (MCP) server that enables AI agents and LLMs to query and analyze Prometheus metrics through standardized interfaces.
logfire-mcp
The Logfire MCP Server is here! :tada:
teslamate-mcp
A Model Context Protocol (MCP) server that provides access to your TeslaMate database, allowing AI assistants to query Tesla vehicle data and analytics.
jvm-mcp-server
This is an implementation project of a JVM-based MCP (Model Context Protocol) server. The project aims to provide a standardized MCP server implementation for the JVM platform, enabling AI models to better interact with the Java ecosystem.