Victorialogs

Name: Victorialogs
Author: VictoriaMetrics-Community

@VictoriaMetrics-Community

代码仓库

关于 Victorialogs

暂无概览

#victorialogs #mcp-server #observability

基本信息

分类

其他

传输方式

stdio

发布者

VictoriaMetrics-Community

提交者

Alexander Marshalov

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.