Mcp Victorialogs
Connect your agent to VictoriaLogs so you can search and reason over production logs via the VictoriaLogs API and docs from the IDE.
Overview
mcp-victorialogs is an Operate-phase MCP server that lets coding agents query VictoriaLogs through its authenticated API and bundled documentation.
What is this MCP server?
- mcp-victorialogs 1.9.0 OCI image with stdio transport to VL_INSTANCE_ENTRYPOINT
- Targets vmlingle or vlselect root URLs (e.g. http://localhost:9428 or play-vmlogs host)
- Required VL_INSTANCE_BEARER_TOKEN for VictoriaLogs API authentication
- Optional MCP_DISABLED_TOOLS to limit exposed MCP tools
- Official VictoriaMetrics repo integration for VictoriaLogs API and documentation
- Server version 1.9.0 per registry JSON
- OCI package ghcr.io/victoriametrics/mcp-victorialogs:1.9.0
- Example ports include 9428 for local vmlingle-style endpoints
Community signal: 84 GitHub stars.
What problem does it solve?
Production log hunts break your flow because the agent cannot search VictoriaLogs—you toggle between grep, dashboards, and chat manually.
Who is it for?
Indie operators on VictoriaLogs (self-hosted or play/demo endpoints) who want MCP log investigation during errors and support tickets.
Skip if: Stacks without VictoriaLogs, or teams that only need metrics without centralized log storage.
What do I get? / Deliverables
After MCP registration with VL_INSTANCE_ENTRYPOINT and bearer token, log search and API-aware answers stay in the same thread as your code fixes.
- Authenticated MCP session to VictoriaLogs
- Agent-accessible log API and documentation tools
- Optional restricted tool list for safer agent operations
Recommended MCP Servers
Journey fit
How it compares
Log analytics MCP for VictoriaLogs, distinct from metrics MCP and trace MCP in the same family.
Common Questions / FAQ
Who is mcp-victorialogs for?
Builders running VictoriaLogs who want AI agents to use the logs API and documentation during Operate troubleshooting.
When should I use mcp-victorialogs?
Use it when debugging production errors, auditing request flows, or drafting LogSQL-style queries with agent help after ship.
How do I add mcp-victorialogs to my agent?
Add stdio MCP config for ghcr.io/victoriametrics/mcp-victorialogs:1.9.0, set VL_INSTANCE_ENTRYPOINT and VL_INSTANCE_BEARER_TOKEN, optionally MCP_DISABLED_TOOLS, then enable the server in your agent.