VictoriaMetrics MCP Server
yincongcyincong/VictoriaMetrics-mcp-server
Integração VictoriaMetrics para queries e escrita de métricas via Claude
Ver no GitHubMCP Server que integra VictoriaMetrics ao Claude, permitindo escrever e consultar dados de séries temporais usando PromQL. Facilita operações de ingestão de métricas, queries em tempo real e análise de dados históricos diretamente via Claude.
Instalação
npx convez-ai yincongcyincong/VictoriaMetrics-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consultar métricas de performance e infraestrutura em tempo real
- Ingerir dados de séries temporais via Prometheus exposition format
- Analisar tendências históricas com PromQL via Claude
- Automatizar workflows de observabilidade e monitoramento
Veredito

MCP server bem estruturado para integração com VictoriaMetrics. Cobre operações essenciais (read, write, query range), tem documentação clara e suporte via Smithery. Ideal para quem precisa consultar métricas ou ingerir dados via Claude em ambientes de observabilidade.
README
A tradução para o português deste README ainda está na fila.
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 | ✅ |
