Victoriametrics MCP Server
VictoriaMetrics time-series data access and documentation lookup for your AI assistant.
Data last scanned today · Reviewed today
Overview
This server acts as a bridge to your VictoriaMetrics instances, enabling AI-assisted monitoring, observability, and debugging. By exposing read-only APIs, it allows users to perform tasks such as querying metrics, exploring series, analyzing cardinality, and testing recording rules through their MCP-compliant client. Beyond data interaction, the server includes local documentation, allowing for contextual lookups without needing external access. It supports configurations for both self-hosted instances and VictoriaMetrics Cloud, facilitating deeper insights into retention policies and relabeling rules.
Our verdict
With a high-risk security score of 48/100, users should approach this server with caution. The score reflects that the project is community-maintained rather than official and lacks an independent editorial review of its read-only mode and authentication mechanisms. Given these factors, it is recommended primarily for users in isolated or non-production test environments where supply-chain security audit requirements are less stringent.
- Zero direct dependencies reduce potential supply-chain vulnerability surface area
- Active development evidenced by commits within the last 20 days
- Includes local, up-to-date documentation for offline reference
- Risk level remains high due to unreviewed authentication and API access
- Community-managed project lacking official maintenance from VictoriaMetrics
- Read-only mode implementation has not undergone formal security verification
Tools
| Tool | Description | Risk |
|---|---|---|
| query | Execute instant PromQL/MetricsQL queries | low |
| query_range | Execute range PromQL/MetricsQL queries over a time period | low |
| metrics | List available metrics | low |
| metrics_metadata | Stored metrics metadata (type, help and unit) | low |
| labels | List available label names | low |
| label_values | List values for a specific label | low |
| series | List available time series | low |
| export | Export raw time series data to JSON or CSV | low |
| rules | View alerting and recording rules | low |
| alerts | View current alerts (firing and pending) | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What kind of API access does this server provide?
This server provides read-only access to almost all VictoriaMetrics APIs, including functionality similar to VMUI such as metrics querying, series exploration, and cardinality analysis.
›Does the server require online access to search documentation?
No, the MCP server contains embedded, up-to-date documentation and can perform searches without an active internet connection.
›What are the core requirements to run this server?
You need a running VictoriaMetrics or VictoriaMetrics Cloud instance, either in single-node or cluster configuration.
›Can I test the server without installing it locally?
Yes, you can use the public endpoint https://play.victoriametrics.com/mcp, which is configured to connect to the public VictoriaMetrics Playground.
›What is the benefit of using Streamable HTTP mode?
Streamable HTTP mode provides a root endpoint featuring a user interface with setup instructions and tools inspection.
›Do I need to compile the server from source?
No, you can either download pre-built binaries from the GitHub releases page or run the server as a Docker container.
Alternatives
Changelog
Badge
Maintain this server? Add the live badge to your README.