About yincongcyincong/VictoriaMetrics-mcp-server
yincongcyincong/VictoriaMetrics-mcp-server is an MCP server published by yincongcyincong in the Data category: mCP Server for the VictoriaMetrics.
The repository has 7 stars and 8 forks, with the last commit 11 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/yincongcyincong/VictoriaMetrics-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about yincongcyincong/VictoriaMetrics-mcp-server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
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 | ✅ |
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.
