VictoriaMetrics

Traducción del documento al español, preservando todos los tokens y estructura.

---

VictoriaMetrics MCP Server

Servidor MCP para VictoriaMetrics.

Instalación mediante Smithery

Para instalar VictoriaMetrics Server para Claude Desktop automáticamente mediante Smithery:

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

Depuración

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

📊 Documentación de la API de herramientas de VictoriaMetrics

1. vm_data_write

Descripción: Escribir datos en la base de datos de VictoriaMetrics.

Parámetros de entrada:

Parámetro	Tipo	Descripción	Obligatorio
metric	object	Etiquetas de la métrica	✅
values	number[]	Array de valores de métrica	✅
timestamps	number[]	Array de marcas de tiempo en segundos Unix	✅

---

2. vm_prometheus_write

Descripción: Importar datos en formato de exposición de Prometheus a VictoriaMetrics.

Parámetros de entrada:

Parámetro	Tipo	Descripción	Obligatorio
data	string	Métricas en formato de exposición de Prometheus	✅

---

3. vm_query_range

Descripción: Consultar datos de series temporales en un rango de tiempo específico.

Parámetros de entrada:

Parámetro	Tipo	Descripción	Obligatorio
query	string	Expresión PromQL	✅
start	number	Marca de tiempo de inicio en segundos Unix	⛔️
end	number	Marca de tiempo de fin en segundos Unix	⛔️
step	string	Ancho del paso de resolución de consulta (p. ej., 10s, 1m)	⛔️

Solo query es obligatorio; los demás campos son opcionales.

---

4. vm_query

Descripción: Consultar el valor actual de una serie temporal.

Parámetros de entrada:

Parámetro	Tipo	Descripción	Obligatorio
query	string	Expresión PromQL a evaluar	✅
time	number	Marca de tiempo de evaluación en segundos Unix	⛔️

---

5. vm_labels

Descripción: Obtener todos los nombres de etiquetas únicos.

Parámetros de entrada: Ninguno

---

6. vm_label_values

Descripción: Obtener todos los valores únicos para una etiqueta específica.

Parámetros de entrada:

Parámetro	Tipo	Descripción	Obligatorio
label	string	Nombre de la etiqueta para obtener valores	✅

---