Mcp Victorialogs
Connects Claude to VictoriaLogs instances for querying and exploring log data through the VictoriaLogs API. You get read-only access to streams, fields, field values, and query statistics, plus embedded documentation search that works offline. Built by the VictoriaMetrics community, it mirrors the functionality available in VictoriaLogs Web UI, so you can query logs, inspect instance parameters, and debug observability issues directly from your Claude conversations. Ships as a Go binary, Docker container, or Helm chart, and supports both stdio and HTTP transport modes. Works with single-node or cluster VictoriaLogs deployments, and they maintain a public playground instance if you want to test it before setting up your own.
- GitHub stars
- 85
- tools
- 13
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Dec 15, 2025
Tools
13 toolsPublic 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
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
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*secretAuthentication token for VictoriaMetrics API
MCP_DISABLED_TOOLSComma-separated list of tools to disable
Readme
Details
- Repository
- github.com/victoriametrics-community/mcp-victorialogs
- Package
ghcr.io/victoriametrics-community/mcp-victorialogs:1.8.0- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active