# mcp-victorialogs [Health: Active]

**Category:** 📊 Monitoring  
**Repository:** https://github.com/VictoriaMetrics/mcp-victorialogs  
**GitHub Stars:** 112  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-victorialogs

## Description
MCP Server for VictoriaLogs. Provides integration with VictoriaLogs API and documentation

## Tools
Capabilities this server exposes over MCP:

- **documentation** — Search documentation resources for the given search query, returning the URIs of the resources that match the search criteria sorted by relevance. This tool can help to get context for any VictoriaLogs related question.
- **facets** — The most frequent values per each log field seen in the logs returned by the given <query> on the given [<start> ... <end>] time range. This tool uses `/select/logsql/facets` endpoint of VictoriaLogs API.
- **field_names** — Get field names from results of the given <query> on the given [<start> ... <end>] time range. The response also contains the number of log results per every field name. This tool uses `/select/logsql/field_names` endpoint of VictoriaLogs API.
- **field_values** — Get unique values for the given <fieldName> field from results of the given <query> on the given [<start> ... <end>] time range. The response also contains the number of log results per every field value. This tool uses `/select/logsql/field_values` endpoint of VictoriaLogs API.
- **flags** — List of non-default flags (parameters) of the VictoriaLogs instance. This tools uses `/flags` endpoint of VictoriaLogs API.
- **hits** — The number of matching log entries for the given <query> on the given [<start> ... <end>] time range grouped by <step> buckets. The returned results are sorted by time. This tool uses `/select/logsql/hits` endpoint of VictoriaLogs API.
- **query** — Executes LogsQL query expression to search log entries. This tool uses `/select/logsql/query` endpoint of VictoriaLogs API.
- **stats_query** — Log stats for the given query at the given timestamp (time) in the format compatible with Prometheus querying API. This tool uses `/select/logsql/stats_query` endpoint of VictoriaLogs API.
- **stats_query_range** — Log stats for the given query on the given [start ... end] time range with the given step interval. The stats is returned in the format compatible with Prometheus querying API. This tool uses `/select/logsql/stats_query_range` endpoint of VictoriaLogs API.
- **stream_field_names** — Get log stream field names from results of the given <query> on the given [<start> ... <end>] time range. The response also contains the number of log results per every field name.. This tool uses `/select/logsql/stream_field_names` endpoint of VictoriaLogs API.
- **stream_field_values** — Get unique values for the given <fieldName> field from results of the given <query> on the given [<start> ... <end>] time range. The response also contains the number of log results per every field value. This tool uses `/select/logsql/stream_field_values` endpoint of VictoriaLogs API.
- **stream_ids** — Get _stream_id values for the log streams from results of the given <query> on the given [<start> ... <end>] time range. The response also contains the number of log results per every _stream_id. This tool uses `/select/logsql/stream_ids` endpoint of VictoriaLogs API.
- **streams** — Get log streams from results of the given <query> on the given [<start> ... <end>] time range. The response also contains the number of log results per every _stream. This tool uses `/select/logsql/streams` endpoint of VictoriaLogs API.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "mcp-victorialogs": {
    "url": "https://play-vmlogs-mcp.victoriametrics.com/mcp"
  }
}
```

## Documentation

## What mcp-victorialogs MCP server does

The mcp-victorialogs MCP server gives an MCP client read-only access to a VictoriaLogs deployment. It works with single-node and cluster installations through the VictoriaLogs HTTP API, and also includes a locally embedded copy of VictoriaLogs documentation that can be searched without network access.

Its supported use cases center on log investigation and observability. An agent can query log records, inspect the available streams, enumerate fields and field values, retrieve instance parameters, and obtain query statistics in a metrics-oriented form. The available functionality corresponds broadly to the read-only operations exposed by the VictoriaLogs web UI.

## How it works

The server receives requests from an MCP client and sends the relevant API requests to the configured VictoriaLogs endpoint. The target URL is supplied through configuration rather than selected by the client for each installation. Optional bearer authentication and custom request headers allow the server to reach protected or specially configured instances.

Two operating modes are described: stdio for local client integrations and Streamable HTTP for network-accessible use. Streamable HTTP mode also provides a root-endpoint UI with setup instructions and tool inspection. A public Streamable HTTP instance is available for trying the server against the VictoriaLogs playground, although it is intended for MCP clients rather than direct browser use.

## Setup and configuration

Install the binary with Go, download a release artifact, run the published container, build from source, or use the available Helm chart. Building from source requires Go 1.26 or newer. A VictoriaLogs instance is required regardless of the installation method.

Set `VL_INSTANCE_ENTRYPOINT` to the VictoriaLogs URL. Authentication can use `VL_INSTANCE_BEARER_TOKEN`, while `VL_INSTANCE_HEADERS` accepts comma-separated key-value pairs for custom HTTP headers. In HTTP or SSE modes, `MCP_PASSTHROUGH_HEADERS` can forward selected headers from incoming MCP requests and takes precedence over matching configured headers. `VL_DEFAULT_TENANT_ID` supplies a fallback tenant in `AccountID:ProjectID` or `AccountID` form, defaulting to `0:0`. Select the transport with `MCP_SERVER_MODE`; stdio is the default.

## Tools and capabilities

The mcp-victorialogs MCP server supports capabilities for:

- Querying and exploring VictoriaLogs records
- Listing log streams
- Listing fields and values
- Reading VictoriaLogs instance parameters
- Returning log query statistics as metrics
- Searching embedded VictoriaLogs documentation
- Inspecting setup instructions and available tools through the HTTP root endpoint

The server is intended for read-only operations. Prompts can combine log queries with documentation searches, depending on the MCP client and model used.

## Limitations and notes

This server does not provide write operations in the described API surface; its documented VictoriaLogs functions are read-only. Access still depends on a reachable VictoriaLogs instance and any required credentials or headers. The quality of generated investigations depends on the MCP client and model handling the returned tools and responses.

The mcp-victorialogs MCP server can be used with the public playground configuration for evaluation, but production deployments should point `VL_INSTANCE_ENTRYPOINT` at the intended VictoriaLogs service. The README specifically demonstrates Claude Desktop and does not document client-specific setup for other clients.

_Full upstream README: https://allmcps.com/mcp/mcp-victorialogs/readme_

