Victorialogs MCP Server
Query VictoriaLogs data and access observability documentation via LLM interfaces.
Data last scanned today · Reviewed today
Overview
The VictoriaLogs MCP Server serves as a specialized gateway for interacting with VictoriaLogs instances through the Model Context Protocol. It exposes the read-only HTTP APIs of VictoriaLogs, allowing users to query logs, inspect streams and field values, and generate statistics from their observability data directly within an AI-assisted environment. Beyond raw data retrieval, the server includes local, up-to-date documentation that AI models can search without external internet access. This integration aims to streamline debugging workflows and provide a comprehensive interface for exploring log metrics and system configurations.
Our verdict
With a security score of 43/100, this server is classified as high risk, primarily because it is a community-maintained project rather than an official release from the VictoriaMetrics vendor. Additionally, critical security aspects such as the authentication method and read-only mode enforcement have not yet been editorially reviewed. It is suitable for internal debugging and log exploration by developers, but caution is advised in sensitive environments until formal security validation occurs.
- Supports zero direct dependencies to minimize supply chain surface
- Provides embedded documentation for offline search capabilities
- Includes features mirroring the standard VictoriaLogs Web UI
- Licensed under the permissive Apache-2.0 open source license
- Security score of 43/100 indicates high risk level
- Community-maintained rather than supported by the official vendor
- Authentication mechanisms lack formal security review
Tools
| Tool | Description | Risk |
|---|---|---|
| documentation | Search in embedded VictoriaLogs documentation | low |
| facets | Most frequent values per each log field | low |
| field_names | List of field names for the query | low |
| field_values | List of field values for the query | low |
| flags | View non-default flags of the VictoriaLogs instance | low |
| hits | The number of matching log entries grouped by buckets | low |
| query | Execute LogsQL queries | low |
| stats_query | Querying log stats for the given time | low |
| stats_query_range | Querying log stats on the given time range | low |
| stream_field_names | List of stream fields for the query | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What kind of API access does this MCP server provide?
This server provides read-only access to VictoriaLogs APIs, covering functions available in the Web UI such as querying logs, listing streams, and calculating query statistics.
›Does the server require internet access for its documentation features?
No, the server includes embedded up-to-date documentation that allows for searching without requiring an active online connection.
›Can I test the server without installing anything locally?
Yes, you can use the public VictoriaMetrics MCP playground instance by pointing your MCP client to the URL https://play-vmlogs-mcp.victoriametrics.com/mcp.
›What are the core requirements to run this server?
You need a running VictoriaLogs instance, either in single-node or cluster mode. If you intend to build the software from source, you must have Go 1.26 or higher installed.
›Is there a specific mode for viewing setup instructions via a browser?
Yes, the root endpoint provides a UI with setup instructions and tools inspection, but this is only available when the server is running in Streamable HTTP mode.
Alternatives
Changelog
Badge
Maintain this server? Add the live badge to your README.