Servidor MCP VictoriaMetrics

Servidor MCP para o VictoriaMetrics.

Instalação via Smithery

Para instalar o Servidor VictoriaMetrics para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude

Depuração

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": ""
            }
        }
    }
}

📊 Documentação da API de Ferramentas do VictoriaMetrics

1. `vm_data_write`

Descrição: Escreve dados no banco de dados VictoriaMetrics.

Parâmetros de Entrada:

Parâmetro	Tipo	Descrição	Obrigatório
`metric`	`object`	Tags da métrica	✅
`values`	`number[]`	Matriz de valores de métricas	✅
`timestamps`	`number[]`	Matriz de timestamps em segundos Unix	✅

2. `vm_prometheus_write`

Descrição: Importa dados no formato de exposição Prometheus para o VictoriaMetrics.

Parâmetros de Entrada:

Parâmetro	Tipo	Descrição	Obrigatório
`data`	`string`	Métricas no formato de exposição Prometheus	✅

3. `vm_query_range`

Descrição: Consulta dados de séries temporais em um intervalo de tempo específico.

Parâmetros de Entrada:

Parâmetro	Tipo	Descrição	Obrigatório
`query`	`string`	Expressão PromQL	✅
`start`	`number`	Timestamp inicial em segundos Unix	⛔️
`end`	`number`	Timestamp final em segundos Unix	⛔️
`step`	`string`	Largura do passo de resolução da consulta (ex.: `10s`, `1m`)	⛔️

Apenas query é obrigatório; os outros campos são opcionais.

4. `vm_query`

Descrição: Consulta o valor atual de uma série temporal.

Parâmetros de Entrada:

Parâmetro	Tipo	Descrição	Obrigatório
`query`	`string`	Expressão PromQL para avaliar	✅
`time`	`number`	Timestamp de avaliação em segundos Unix	⛔️

5. `vm_labels`

Descrição: Obtém todos os nomes de rótulos exclusivos.

Parâmetros de Entrada: Nenhum

6. `vm_label_values`

Descrição: Obtém todos os valores exclusivos para um rótulo específico.

Parâmetros de Entrada:

Parâmetro	Tipo	Descrição	Obrigatório
`label`	`string`	Nome do rótulo para obter valores	✅

VictoriaMetrics

Documentação