Victoriametrics Logs MCP, developed by Nielsvbrecht, is a free MCP server designed to connect VictoriaLogs instances with AI assistants. Built with Go 1.24+, this tool exposes observability data and operational capabilities from VictoriaLogs in a structured format. It supports various distribution methods including Helm Charts, Docker images, and pre-built binaries, alongside source installation. Its core function is to allow AI clients to interact with VictoriaLogs data through the Model Context Protocol standard, enabling advanced log analysis and debugging workflows.

What does Victoriametrics Logs MCP connect to?

Victoriametrics Logs MCP connects directly to a VictoriaLogs instance, which can be either a single-node or a cluster deployment. Categorized as an MCP server, its primary purpose is to expose observability data and operational capabilities from VictoriaLogs. It structures this data for consumption by AI assistants, adhering to the Model Context Protocol standard. This allows AI systems to access and interpret log information and operational details from your VictoriaLogs deployment.

Core features and tools

The MCP server mirrors most read-only APIs found in the VictoriaLogs Web UI. Key callable tools include querying logs and exploring logs data, showing parameters of the VictoriaLogs instance, listing available streams, fields, and field values, and querying statistics for logs as metrics. It also offers a UI with setup instructions and tool inspection on its root endpoint when in Streamable HTTP mode. Additionally, it provides embedded, searchable, up-to-date documentation for offline access.

Who is it for?

Victoriametrics Logs MCP is primarily for engineers engaged in logs, observability, and debugging tasks, as well as for AI agents and automation tools. Its design enables AI clients to interact with VictoriaLogs data for analysis and troubleshooting. Confirmed compatible AI clients include Claude Desktop, Cursor, and Visual Studio Code with relevant extensions. Skip this if your workflow does not involve VictoriaLogs instances or AI-driven observability.

How to get started

The server authenticates using an API key passed as an environment variable. Setup requires specifying the VictoriaLogs instance via VL_INSTANCE_ENTRYPOINT and optionally VL_INSTANCE_BEARER_TOKEN for API authentication, supporting stdio, sse, and http transport protocols.

Use cases

• Natural language log querying and exploration, allowing AI assistants to analyze log data and visualize distributions.
• Debugging and troubleshooting, where AI agents analyze telemetry data, inspect instance parameters, and assist with root cause analysis.
• Offline documentation search, enabling AI clients to access and search embedded VictoriaLogs documentation without an internet connection.

Victoriametrics Logs MCP provides a crucial bridge for integrating VictoriaLogs data with AI-powered workflows. It enables AI assistants to perform detailed log analysis, assist with debugging, and access documentation directly. This tool supports various AI clients and transport protocols, offering flexibility in deployment and interaction. Its focus on exposing read-only VictoriaLogs APIs to AI agents makes it a specialized solution for modern observability challenges. Try natural language log querying and exploration using an AI assistant.