mcp-victorialogs

Overview

This is a fully functional MCP server that bridges VictoriaLogs with AI models and tools. It implements the Model Context Protocol specification, allowing seamless integration with VictoriaLogs APIs. The server exposes tools for querying logs, exploring data, showing instance parameters, listing streams/fields, and querying statistics. It supports multiple modes including stdio, SSE, and HTTP, with comprehensive configuration options and built-in documentation search capabilities.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query_logsquery_logs(query: string, start_time?: string, end_time?: string, step?: string) -> object

  Query logs from VictoriaLogs with optional time range and step parameters

  Try:Show me error logs from the last hourTry:Query logs with keyword authentication failure
• show_parametersshow_parameters() -> object

  Show parameters of the VictoriaLogs instance

  Try:What are the current configuration parameters?Try:Show me VictoriaLogs instance settings
• list_streamslist_streams() -> object

  List available streams in VictoriaLogs

  Try:What log streams are available?Try:List all streams in the system
• list_fieldslist_fields(stream?: string) -> object

  List available fields in specified stream or all streams

  Try:What fields are available in the nginx stream?Try:Show all fields across all streams
• list_field_valueslist_field_values(field: string, stream?: string) -> object

  List values for a specific field in a stream

  Try:What are the possible values for the status field?Try:Show distinct values of the response_code field
• query_statsquery_stats(query: string, start_time?: string, end_time?: string) -> object

  Query statistics for logs as metrics

  Try:Show me query statistics for the last 24 hoursTry:Get metrics for failed API calls
• search_docssearch_docs(query: string) -> object

  Search embedded VictoriaLogs documentation

  Try:How do I set up alerts in VictoriaLogs?Try:Search for information about log retention policies

Comparable tools

Installation

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

docker run -d --name mcp-victorialogs \
  -e VL_INSTANCE_ENTRYPOINT=https://your-victorialogs-url \
  -e MCP_SERVER_MODE=http \
  -e MCP_LISTEN_ADDR=:8081 \
  -p 8081:8081 \
  ghcr.io/victoriametrics/mcp-victorialogs

{
  "mcpServers": {
    "victorialogs": {
      "command": "mcp-victorialogs",
      "args": ["--env", "VL_INSTANCE_ENTRYPOINT=https://your-victorialogs-url"]
    }
  }
}

FAQ

What VictoriaLogs APIs are supported?

The MCP server supports almost all read-only APIs of VictoriaLogs, including query functions available in the Web UI.

What transport modes are available?

Three modes are supported: stdio (default), SSE (Server-Sent Events), and HTTP (Streamable HTTP).

Compare mcp-victorialogs with