Skip to main content
Glama

mcp-victorialogs

Servidor MCP de VictoriaLogs

Último lanzamiento insignia de herrería LicenciaFlojoincógnitaReddit

La implementación del servidor de Protocolo de Contexto de Modelo (MCP) para VictoriaLogs .

Esto proporciona acceso a su instancia de VictoriaLogs y una integración fluida con las API y la documentación de VictoriaLogs . Le ofrece una interfaz completa para registros, observabilidad y tareas de depuración relacionadas con sus instancias de VictoriaLogs, además de habilitar capacidades avanzadas de automatización e interacción para ingenieros y herramientas.

Características

Este servidor MCP le permite utilizar casi todas las API de solo lectura de VictoriaLogs, es decir, todas las funciones disponibles en la interfaz web :

  • Consulta de registros y exploración de datos de registros

  • Mostrar parámetros de su instancia de VictoriaLogs

  • Listado de secuencias, campos y valores de campo disponibles

  • Consultar estadísticas de los registros como métricas

Además, el servidor MCP contiene documentación actualizada incorporada y puede buscarla sin acceso en línea.

Puede encontrar más detalles sobre las herramientas y indicaciones exactas disponibles en la sección Uso .

Puede combinar la funcionalidad de herramientas y la búsqueda de documentos en sus indicaciones e idear excelentes escenarios de uso para su instancia de VictoriaLogs. Tenga en cuenta que la calidad del servidor MCP y sus respuestas dependen en gran medida de las capacidades de su cliente y de la calidad del modelo que utilice.

También puede combinar el servidor MCP con otros servidores MCP relacionados con la observación o la búsqueda de documentos y obtener resultados aún más potentes.

Requisitos

Instalación

Ir

go install github.com/VictoriaMetrics-Community/mcp-victorialogs/cmd/mcp-victorialogs@latest

Código fuente

git clone https://github.com/VictoriaMetrics-Community/mcp-victorialogs.git cd mcp-victorialogs go build -o bin/mcp-victorialogs ./cmd/mcp-victorialogs/main.go # after that add bin/mcp-victorialogs file to your PATH

Binarios

Simplemente descargue la última versión desde la página de versiones y colóquela en su RUTA.

Estibador

Muy pronto...

Herrería

Para instalar VictoriaLogs MCP Server para su cliente automáticamente a través de Smithery , puede utilizar los siguientes comandos:

# Get the list of supported MCP clients npx -y @smithery/cli list clients #Available clients: # claude # cline # windsurf # roocode # witsy # enconvo # cursor # vscode # vscode-insiders # boltai # amazon-bedrock # Install VictoriaLogs MCP server for your client npx -y @smithery/cli install @VictoriaMetrics-Community/mcp-victorialogs --client <YOUR-CLIENT-NAME> # and follow the instructions

Configuración

El servidor MCP para VictoriaLogs se configura a través de variables de entorno:

Variable

Descripción

Requerido

Por defecto

Valores permitidos

VL_INSTANCE_ENTRYPOINT

URL a la instancia de VictoriaLogs

-

-

VL_INSTANCE_BEARER_TOKEN

Token de autenticación para la API de VictoriaLogs

No

-

-

MCP_SERVER_MODE

Modo de funcionamiento del servidor

No

stdio

stdio

,

sse

MCP_SSE_ADDR

Dirección para que el servidor SSE escuche

No

:8081

-

Ejemplos de configuración

# For a public playground export VL_INSTANCE_ENTRYPOINT="https://play-vmlogs.victoriametrics.com" # Server mode export MCP_SERVER_MODE="sse" export MCP_SSE_ADDR="0.0.0.0:8081"

Configuración en clientes

Cursor

Vaya a: Settings -> Cursor Settings -> MCP -> Add new global MCP server y pegue la siguiente configuración en su archivo Cursor ~/.cursor/mcp.json :

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Consulte la documentación de Cursor MCP para obtener más información.

Escritorio de Claude

Agregue esto a su archivo claude_desktop_config.json de Claude Desktop (puede encontrarlo si abre Settings -> Developer -> Edit config ):

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Consulte la documentación de Claude Desktop MCP para obtener más información.

Claude Code

Ejecute el comando:

claude mcp add victorialogs -- /path/to/mcp-victorialogs \ -e VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> \ -e VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN>

Consulte la documentación de Claude Code MCP para obtener más información.

Código de Visual Studio

Agregue esto a su archivo de configuración MCP de VS Code:

{ "servers": { "victorialogs": { "type": "stdio", "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Consulte la documentación de VS Code MCP para obtener más información.

Zed

Agregue lo siguiente a su archivo de configuración de Zed:

"context_servers": { "victorialogs": { "command": { "path": "/path/to/mcp-victorialogs", "args": [], "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } }, "settings": {} } } }

Consulte la documentación de Zed MCP para obtener más información.

IDE de JetBrains

  • Abra Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP) .

  • Haga clic Add (+)

  • Seleccionar As JSON

  • Coloque lo siguiente en el campo de entrada:

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Windsurf

Agregue lo siguiente a su archivo de configuración Windsurf MCP.

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Consulte la documentación de Windsurf MCP para obtener más información.

Amazon Bedrock

Muy pronto....

Usando Docker en lugar de binario

Muy pronto...

Uso

Después de instalar y configurar el servidor MCP, puede comenzar a usarlo con su cliente MCP favorito.

Puedes iniciar un diálogo con el asistente de IA desde la frase:

Use MCP VictoriaLogs in the following answers

Pero no es obligatorio, simplemente puedes comenzar a hacer preguntas y el asistente utilizará automáticamente las herramientas y la documentación para brindarte las mejores respuestas.

Conjunto de herramientas

MCP VictoriaLogs proporciona numerosas herramientas para interactuar con su instancia de VictoriaLogs.

Aquí hay una lista de herramientas disponibles:

Herramienta

Descripción

documentation

Buscar en la documentación integrada de VictoriaLogs

facets

Valores más frecuentes por cada campo de registro

field_names

Lista de nombres de campos para la consulta

field_values

Lista de valores de campo para la consulta

flags

Ver indicadores no predeterminados de la instancia VictoriaLogs

hits

El número de entradas de registro coincidentes agrupadas por depósitos

query

Ejecutar consultas LogsQL

stats_query

Consulta de estadísticas de registro para el tiempo determinado

stats_query_range

Consulta de estadísticas de registro en el rango de tiempo dado

stream_field_names

Lista de campos de flujo para la consulta

stream_field_names

Lista de valores de campos de flujo para la consulta

stream_ids

Lista de identificadores de flujo para la consulta

streams

Lista de flujos de la consulta

Indicaciones

El servidor incluye indicaciones predefinidas para tareas comunes.

Estos son solo ejemplos por el momento, la biblioteca de indicaciones se agregará en el futuro:

Inmediato

Descripción

documentation

Busque en la documentación de VictoriaLogs temas específicos

Descargo de responsabilidad

Los servicios y agentes de IA, junto con los servidores MCP como este, no pueden garantizar la precisión, integridad ni fiabilidad de los resultados. Debe verificar los resultados obtenidos con IA. La calidad del servidor MCP y sus respuestas dependen en gran medida de las capacidades de su cliente y de la calidad del modelo que utilice.

Contribuyendo

¡Agradecemos sus contribuciones al proyecto MCP VictoriaLogs! No dude en enviar problemas, solicitudes de funcionalidad o solicitudes de incorporación de cambios.

Related MCP Servers

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VictoriaMetrics-Community/mcp-victorialogs'

If you have feedback or need assistance with the MCP directory API, please join our Discord server