Victorialogs

What is Victorialogs?

Victorialogs is an MCP (Model Context Protocol) server that provides access to your VictoriaLogs instance and its read‑only APIs, along with embedded up‑to‑date documentation. It is designed for engineers working with logs, observability, and debugging tasks.

How to use Victorialogs?

Install via Go, from source, or download a binary release. Set the required environment variable VL_INSTANCE_ENTRYPOINT (and optionally VL_INSTANCE_BEARER_TOKEN), then configure the server in your MCP client (e.g., Cursor, Claude Desktop, VS Code). After configuration, start asking questions – the assistant will automatically use the tools and documentation.

Key features of Victorialogs

• Query logs and explore log data using LogsQL.
• Show parameters and non‑default flags of your VictoriaLogs instance.
• List available streams, fields, and field values.
• Query log statistics as metrics for given time ranges.
• Search embedded VictoriaLogs documentation without online access.

Use cases of Victorialogs

• Debugging production issues by querying logs directly from an AI assistant.
• Automating observability tasks across multiple VictoriaLogs instances.
• Combining log queries with documentation searches for troubleshooting.
• Enabling non‑GUI log analysis for CLI‑focused workflows.

FAQ from Victorialogs

What are the requirements to run Victorialogs?

You need a running VictoriaLogs instance (single‑node or cluster). To build from source, Go 1.24 or higher is required; prebuilt binaries are also available.

How do I authenticate to my VictoriaLogs instance?

Set the VL_INSTANCE_BEARER_TOKEN environment variable. This token is passed to the VictoriaLogs API for authentication.

What transports does Victorialogs support?

The server supports both stdio (default) and sse (Server‑Sent Events) modes, configurable via MCP_SERVER_MODE.

Is documentation search available offline?

Yes. The server contains an embedded copy of VictoriaLogs documentation and can search it without internet access.

What APIs does Victorialogs expose?

It provides read‑only tools – queries, stats, field/stream listings, flags, and documentation search – mirroring the functions available in the VictoriaLogs Web UI.