VictoriaLogs
MCP Server for VictoriaLogs. Provides integration with VictoriaLogs API and documentation
What is VictoriaLogs?
VictoriaLogs is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for victorialogs. provides integration with victorialogs api and documentation
MCP Server for VictoriaLogs. Provides integration with VictoriaLogs API and documentation
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Server for VictoriaLogs. Provides integration with Victo
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-victorialogsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use VictoriaLogs
The VictoriaLogs MCP Server connects AI assistants to VictoriaLogs, the high-performance log management system from VictoriaMetrics, enabling natural language log queries, field exploration, and frequency analysis using the LogsQL query language. It embeds VictoriaLogs documentation so the AI can answer questions about query syntax and configuration without external lookups, and supports stdio, SSE, and HTTP transport modes for flexible deployment. SREs and platform engineers use it to investigate incidents, explore log streams, and analyze log patterns directly from an AI assistant without needing to write LogsQL manually.
Prerequisites
- A running VictoriaLogs instance (self-hosted or https://play-vmlogs.victoriametrics.com for testing)
- Go 1.21 or later installed (for building from source), or Docker for container-based deployment
- An MCP-compatible client such as Claude Desktop or Claude Code
- Optional: VL_INSTANCE_BEARER_TOKEN if your VictoriaLogs instance requires authentication
Install the binary via Go
Install the mcp-victorialogs binary directly using Go's install command.
go install github.com/VictoriaMetrics/mcp-victorialogs/cmd/mcp-victorialogs@latestOr run with Docker
Alternatively, run the server as a Docker container in HTTP mode. Replace the VL_INSTANCE_ENTRYPOINT with your VictoriaLogs instance URL.
docker run -d --name mcp-victorialogs \
-e VL_INSTANCE_ENTRYPOINT=https://play-vmlogs.victoriametrics.com \
-e MCP_SERVER_MODE=http \
-e MCP_LISTEN_ADDR=:8081 \
-p 8081:8081 \
ghcr.io/victoriametrics/mcp-victorialogsConfigure environment variables
Set the required VL_INSTANCE_ENTRYPOINT and any optional auth or transport variables before running the server.
export VL_INSTANCE_ENTRYPOINT=https://your-victorialogs.example.com
export VL_INSTANCE_BEARER_TOKEN=your-bearer-token # if auth is required
export MCP_SERVER_MODE=stdio # stdio | sse | httpConfigure Claude Desktop for stdio mode
Add the VictoriaLogs MCP server to claude_desktop_config.json. stdio mode is recommended for local binary deployments.
{
"mcpServers": {
"victorialogs": {
"command": "mcp-victorialogs",
"args": [],
"env": {
"VL_INSTANCE_ENTRYPOINT": "https://your-victorialogs.example.com",
"VL_INSTANCE_BEARER_TOKEN": "your-bearer-token",
"MCP_SERVER_MODE": "stdio"
}
}
}
}Restart your client and verify
Restart Claude Desktop and ask a log query to verify the connection to your VictoriaLogs instance.
VictoriaLogs Examples
Client configuration
Complete claude_desktop_config.json entry for VictoriaLogs MCP server in stdio mode using the installed binary.
{
"mcpServers": {
"victorialogs": {
"command": "mcp-victorialogs",
"args": [],
"env": {
"VL_INSTANCE_ENTRYPOINT": "https://play-vmlogs.victoriametrics.com",
"MCP_SERVER_MODE": "stdio"
}
}
}
}Prompts to try
Use these prompts to query and explore your VictoriaLogs data through the AI assistant.
- "Query VictoriaLogs for all error-level logs in the last 15 minutes"
- "Show me the most frequent log fields in the 'nginx' stream"
- "How many log entries were received per hour over the last 24 hours?"
- "Find all logs containing 'connection refused' from the database service"
- "What are the top 10 most common values for the 'status_code' field?"Troubleshooting VictoriaLogs
Connection refused to VictoriaLogs instance
Verify VL_INSTANCE_ENTRYPOINT is the correct URL including protocol and port (e.g., http://localhost:9428). Test connectivity with 'curl http://localhost:9428/health' from the same machine running the MCP server.
Authentication errors when querying logs
If your VictoriaLogs instance requires authentication, set VL_INSTANCE_BEARER_TOKEN to a valid bearer token, or use VL_INSTANCE_HEADERS to pass custom HTTP headers like 'Authorization: Basic ...'.
mcp-victorialogs binary not found after go install
Ensure $(go env GOPATH)/bin is in your PATH. Run 'export PATH=$PATH:$(go env GOPATH)/bin' and retry. Alternatively use the Docker image which requires no PATH configuration.
Frequently Asked Questions about VictoriaLogs
What is VictoriaLogs?
VictoriaLogs is a Model Context Protocol (MCP) server that mcp server for victorialogs. provides integration with victorialogs api and documentation It connects AI assistants to external tools and data sources through a standardized interface.
How do I install VictoriaLogs?
Follow the installation instructions on the VictoriaLogs GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with VictoriaLogs?
VictoriaLogs works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is VictoriaLogs free to use?
Yes, VictoriaLogs is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
VictoriaLogs Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to VictoriaLogs? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up VictoriaLogs in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use VictoriaLogs?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.