mcp-victorialogs

Servidor MCP de VictoriaLogs

Licencia Flojo incógnita Reddit

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

Instancia VictoriaLogs ( nodo único o clúster )
Vaya a 1.24 o superior (si desea compilar desde la fuente)

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	Sí	-	-
`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.