VictoriaMetrics MCP Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/yincongcyincong-victoriametrics-mcp-server-badge.png)](https://mseep.ai/app/yincongcyincong-victoriametrics-mcp-server)
2 
3# VictoriaMetrics MCP Server
4[![smithery badge](https://smithery.ai/badge/@yincongcyincong/victoriametrics-mcp-server)](https://smithery.ai/server/@yincongcyincong/victoriametrics-mcp-server)
5 
6<a href="https://glama.ai/mcp/servers/@yincongcyincong/VictoriaMetrics-mcp-server">
7  <img width="380" height="200" src="https://glama.ai/mcp/servers/@yincongcyincong/VictoriaMetrics-mcp-server/badge" alt="VictoriaMetrics-mcp-server MCP server" />
8</a>
9 
10MCP Server for the VictoriaMetrics.
11 
12### Installing via Smithery
13 
14To install VictoriaMetrics Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@yincongcyincong/victoriametrics-mcp-server):
15 
16```bash
17npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude
18```
19 
20## Debug
21```
22npx @modelcontextprotocol/inspector -e VM_URL=http://127.0.0.1:8428  node src/index.js
23 
24```
25 
26### NPX
27 
28```json
29{
30    "mcpServers": {
31        "victoriametrics": {
32            "command": "npx",
33            "args": [
34                "-y",
35                "@yincongcyincong/victoriametrics-mcp-server"
36            ],
37            "env": {
38                "VM_URL": "",
39                "VM_SELECT_URL": "",
40                "VM_INSERT_URL": ""
41            }
42        }
43    }
44}
45```
46 
47### 📊 VictoriaMetrics Tools API Documentation
48 
49## 1. `vm_data_write`
50 
51**Description**: Write data to the VictoriaMetrics database.
52 
53**Input Parameters**:
54 
55| Parameter     | Type        | Description                                | Required |
56|---------------|-------------|--------------------------------------------|----------|
57| `metric`      | `object`    | Tags of the metric                         | ✅        |
58| `values`      | `number[]`  | Array of metric values                     | ✅        |
59| `timestamps`  | `number[]`  | Array of timestamps in Unix seconds        | ✅        |
60 
61---
62 
63## 2. `vm_prometheus_write`
64 
65**Description**: Import Prometheus exposition format data into VictoriaMetrics.
66 
67**Input Parameters**:
68 
69| Parameter | Type     | Description                                     | Required |
70|-----------|----------|-------------------------------------------------|----------|
71| `data`    | `string` | Metrics in Prometheus exposition format         | ✅        |
72 
73---
74 
75## 3. `vm_query_range`
76 
77**Description**: Query time series data over a specific time range.
78 
79**Input Parameters**:
80 
81| Parameter | Type     | Description                                     | Required |
82|-----------|----------|-------------------------------------------------|----------|
83| `query`   | `string` | PromQL expression                               | ✅        |
84| `start`   | `number` | Start timestamp in Unix seconds                 | ⛔️        |
85| `end`     | `number` | End timestamp in Unix seconds                   | ⛔️        |
86| `step`    | `string` | Query resolution step width (e.g., `10s`, `1m`) | ⛔️        |
87 
88> Only `query` is required; the other fields are optional.
89 
90---
91 
92## 4. `vm_query`
93 
94**Description**: Query the current value of a time series.
95 
96**Input Parameters**:
97 
98| Parameter | Type     | Description                             | Required |
99|-----------|----------|-----------------------------------------|----------|
100| `query`   | `string` | PromQL expression to evaluate           | ✅        |
101| `time`    | `number` | Evaluation timestamp in Unix seconds    | ⛔️        |
102 
103---
104 
105## 5. `vm_labels`
106 
107**Description**: Get all unique label names.
108 
109**Input Parameters**: None
110 
111---
112 
113## 6. `vm_label_values`
114 
115**Description**: Get all unique values for a specific label.
116 
117**Input Parameters**:
118 
119| Parameter | Type     | Description                  | Required |
120|-----------|----------|------------------------------|----------|
121| `label`   | `string` | Label name to get values for | ✅        |
122 
123---