victoriametrics-mcp-server
MCP Server for the VictoriaMetrics.
Documentation

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 claudeDebug
npx @modelcontextprotocol/inspector -e VM_URL=http://127.0.0.1:8428 node src/index.jsNPX
{
"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 `query` is 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 | โ |
Frequently asked questions
What is victoriametrics-mcp-server?
victoriametrics-mcp-server is MCP Server for the VictoriaMetrics.
How do I install victoriametrics-mcp-server?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is victoriametrics-mcp-server open source?
Yes โ it is hosted on GitHub at https://github.com/yincongcyincong/VictoriaMetrics-mcp-server and has 7 stars.
Related MCP tools
๐ฅ Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.
Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency.
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
A server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.
๐งฉ MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP