Happy slice of mcp pizzaMCP.pizza

mcp-victorialogs

MCP.Pizza Chef: VictoriaMetrics

The mcp-victorialogs is an MCP server implementation that integrates with VictoriaLogs, enabling comprehensive read-only access to logs data, instance parameters, and query statistics. It supports almost all VictoriaLogs APIs used in the Web UI, facilitating advanced log querying, exploration, and observability workflows. This server empowers engineers and tools to automate and interact with VictoriaLogs instances seamlessly for debugging and monitoring purposes.

Use This MCP server To

Query and explore logs data from VictoriaLogs instances Retrieve parameters and configuration details of VictoriaLogs List available log streams, fields, and field values Access query statistics for performance and usage analysis Integrate VictoriaLogs data into AI workflows for observability Automate log-based debugging and monitoring tasks Enable real-time log data retrieval for incident response Combine VictoriaLogs logs with other data sources via MCP

README

VictoriaLogs MCP Server

The implementation of Model Context Protocol (MCP) server for VictoriaLogs.

This provides access to your VictoriaLogs instance and seamless integration with VictoriaLogs APIs and documentation. It can give you a comprehensive interface for logs, observability, and debugging tasks related to your VictoriaLogs instances, enable advanced automation and interaction capabilities for engineers and tools.

Features

This MCP server allows you to use almost all read-only APIs of VictoriaLogs, i.e. all functions available in Web UI:

  • Querying logs and exploring logs data
  • Showing parameters of your VictoriaLogs instance
  • Listing available streams, fields, field values
  • Query statistics for the logs as metrics

In addition, the MCP server contains embedded up-to-date documentation and is able to search it without online access.

More details about the exact available tools and prompts can be found in the Usage section.

You can combine functionality of tools, docs search in your prompts and invent great usage scenarios for your VictoriaLogs instance. And please note the fact that the quality of the MCP Server and its responses depends very much on the capabilities of your client and the quality of the model you are using.

You can also combine the MCP server with other observability or doc search related MCP Servers and get even more powerful results.

Requirements

Installation

Go

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

Source Code

mcp-victorialogs FAQ

How does mcp-victorialogs connect to my VictoriaLogs instance?
It uses VictoriaLogs HTTP APIs to securely query and retrieve logs and metadata.
Can I write or modify logs using mcp-victorialogs?
No, this MCP server provides read-only access to VictoriaLogs data and does not support write operations.
What types of queries can I perform with mcp-victorialogs?
You can perform log queries, explore streams, fields, and retrieve query statistics similar to VictoriaLogs Web UI.
Is authentication required to use mcp-victorialogs?
Yes, it supports authentication methods compatible with VictoriaLogs HTTP API to ensure secure access.
Can mcp-victorialogs be used with multiple VictoriaLogs instances?
Yes, it can be configured to connect to different VictoriaLogs instances as needed.
Does mcp-victorialogs support integration with multiple LLM providers?
Yes, it is designed to work with various LLMs like OpenAI, Claude, and Gemini through the MCP protocol.
How does mcp-victorialogs handle large volumes of log data?
It leverages VictoriaLogs efficient querying capabilities and streams data as needed to optimize performance.
What are the main benefits of using mcp-victorialogs?
It simplifies log data access, enables automation, and integrates VictoriaLogs observability into AI workflows.