Back to Home
VictoriaMetrics-Community icon

mcp-victorialogs

Verified Safe

by VictoriaMetrics-Community

Overview

The Model Context Protocol (MCP) server for VictoriaLogs provides an interface for AI clients to interact with VictoriaLogs APIs and documentation, enabling querying logs, exploring data, viewing instance parameters, and accessing log statistics.

Installation

Run Command
docker run -d --name mcp-victorialogs -e VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> -e VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN> -e MCP_SERVER_MODE=http -e MCP_LISTEN_ADDR=:8081 -p 8081:8081 ghcr.io/victoriametrics-community/mcp-victorialogs

Environment Variables

  • VL_INSTANCE_ENTRYPOINT
  • VL_INSTANCE_BEARER_TOKEN

Security Notes

The server is written in Go, which reduces common security vulnerabilities found in less type-safe or dynamic languages. It uses environment variables for sensitive configuration like `VL_INSTANCE_BEARER_TOKEN`, which is good practice. HTTP requests to the VictoriaLogs instance are constructed using `net/url.Query().Add()`, which properly URL-encodes parameters, mitigating injection risks. Custom HTTP headers are handled after explicit `Authorization` headers, preventing accidental overrides of the primary authentication token. The main security consideration lies in the configuration of the upstream VictoriaLogs instance; if not properly secured with access controls (e.g., via vmauth), broad or resource-intensive queries issued through this MCP server could pose risks to the backend. The MCP server itself appears to follow good security practices within its scope.

Similar Servers

Stats

Interest Score45
Security Score8
Cost ClassHigh
Avg Tokens50000
Stars46
Forks9
Last Update2026-01-14

Tags

VictoriaLogsLoggingObservabilityMCP ServerGoAPI ProxyLogsQLDocumentation Search