victoriametrics avatar

Mcp Victorialogs

victoriametrics/mcp-victorialogs

Connects Claude to your VictoriaLogs instance for querying and exploring log data through its HTTP API. Exposes read-only operations like log queries, stream listing, field exploration, and query statistics. Also bundles searchable VictoriaLogs documentation for offline reference. Useful when you need to investigate logs, debug observability pipelines, or analyze log patterns without switching contexts. Supports both single-node and cluster deployments. Works with the public playground instance if you want to test capabilities before pointing it at your own infrastructure. The stdio transport means it runs locally alongside your Claude Desktop client.

GitHub stars
85
tools
13
auth
Secret needed
transport
STDIO
env vars
3
last updated
Apr 10, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

documentationSearch in embedded VictoriaLogs documentation

Search in embedded VictoriaLogs documentation

No parameter schema in public metadata yet.

facetsMost frequent values per each log field

Most frequent values per each log field

No parameter schema in public metadata yet.

field_namesList of field names for the query

List of field names for the query

No parameter schema in public metadata yet.

field_valuesList of field values for the query

List of field values for the query

No parameter schema in public metadata yet.

flagsView non-default flags of the VictoriaLogs instance

View non-default flags of the VictoriaLogs instance

No parameter schema in public metadata yet.

hitsThe number of matching log entries grouped by buckets

The number of matching log entries grouped by buckets

No parameter schema in public metadata yet.

queryExecute LogsQL queries

Execute LogsQL queries

No parameter schema in public metadata yet.

stats_queryQuerying log stats for the given time

Querying log stats for the given time

No parameter schema in public metadata yet.

stats_query_rangeQuerying log stats on the given time range

Querying log stats on the given time range

No parameter schema in public metadata yet.

stream_field_namesList of stream fields for the query

List of stream fields for the query

No parameter schema in public metadata yet.

stream_field_valuesList of stream field values for the query

List of stream field values for the query

No parameter schema in public metadata yet.

stream_idsList of stream IDs for the query

List of stream IDs for the query

No parameter schema in public metadata yet.

streamsList of streams for the query

List of streams for the query

No parameter schema in public metadata yet.

Sponsors

Configuration

VL_INSTANCE_ENTRYPOINT*

URL to VictoriaMetrics instance (it should be root URL of vmlingle or vlselect), for example http://localhost:9428 or https://play-vmlogs.victoriametrics.com

VL_INSTANCE_BEARER_TOKEN*secret

Authentication token for VictoriaMetrics API

MCP_DISABLED_TOOLS

Comma-separated list of tools to disable

Readme

VictoriaLogs MCP Server

Latest Release License Slack X Reddit

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


View the full README on GitHub

Details

Repository
github.com/victoriametrics/mcp-victorialogs
Package
ghcr.io/victoriametrics/mcp-victorialogs:1.9.0
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from victoriametrics