convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
yincongcyincong

VictoriaMetrics MCP Server

yincongcyincong/VictoriaMetrics-mcp-server

Integração VictoriaMetrics para queries e escrita de métricas via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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-server

1 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

Estrelas
8
Forks
7
Acompanhando
1
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
4

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.

MseeP.ai Security Assessment Badge

VictoriaMetrics MCP Server

smithery badge

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:

ParameterTypeDescriptionRequired
metricobjectTags of the metric✅
valuesnumber[]Array of metric values✅
timestampsnumber[]Array of timestamps in Unix seconds✅

2. vm_prometheus_write

Description: Import Prometheus exposition format data into VictoriaMetrics.

Input Parameters:

ParameterTypeDescriptionRequired
datastringMetrics in Prometheus exposition format✅

3. vm_query_range

Description: Query time series data over a specific time range.

Input Parameters:

ParameterTypeDescriptionRequired
querystringPromQL expression✅
startnumberStart timestamp in Unix seconds⛔️
endnumberEnd timestamp in Unix seconds⛔️
stepstringQuery 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:

ParameterTypeDescriptionRequired
querystringPromQL expression to evaluate✅
timenumberEvaluation 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:

ParameterTypeDescriptionRequired
labelstringLabel name to get values for✅

Ver o original no GitHub

Bom para

Relacionados