VictoriaMetrics MCP Server

Name: VictoriaMetrics MCP Server
Author: VictoriaMetrics-Community

@VictoriaMetrics-Community

代码仓库主页

关于 VictoriaMetrics MCP Server

The implementation of Model Context Protocol (MCP) server for VictoriaMetrics

#victoriametrics #mcp-server #monitoring #observability #mcp #ai #metrics

基本信息

分类

其他

许可证

Apache-2.0

运行时

传输方式

stdio

发布者

VictoriaMetrics-Community

配置

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

{
  "mcpServers": {
    "victoriametrics": {
      "command": "/path/to/mcp-victoriametrics",
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>"
      }
    }
  }
}

工具

未检测到工具

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

概览

What is VictoriaMetrics MCP Server?

The VictoriaMetrics MCP Server is an implementation of the Model Context Protocol (MCP) that provides an interface to VictoriaMetrics instances. It enables AI assistants and tools to query metrics, explore data, search documentation, and perform monitoring and debugging tasks using VictoriaMetrics read-only APIs.

How to use VictoriaMetrics MCP Server?

Install via pre-built binaries, Docker, or build from source. Configure environment variables such as VM_INSTANCE_ENTRYPOINT and VM_INSTANCE_TYPE to point to your VictoriaMetrics instance. Then connect an MCP-compatible client to the server (stdio, SSE, or Streamable HTTP modes). A public test instance is available at https://play-mcp.victoriametrics.com/mcp.

Key features of VictoriaMetrics MCP Server

Query metrics and explore data, including graph rendering
List, export metrics, labels, label values, and series
Analyze and test alerting and recording rules
Show VictoriaMetrics instance configuration parameters
Explore cardinality and metrics usage statistics
Debug relabeling, downsampling, and retention policies
Embedded up-to-date documentation searchable offline

Use cases of VictoriaMetrics MCP Server

AI-assisted monitoring and observability of VictoriaMetrics instances
Automated debugging and investigation of metric data
Integration with MCP-compatible clients for natural language queries
Testing and validating alerting and recording rules without a UI

FAQ from VictoriaMetrics MCP Server

What are the prerequisites to run the server?

You need a VictoriaMetrics instance (single-node or cluster) or a VictoriaMetrics Cloud account. To build from source, Go 1.26+ is required; pre-built binaries do not require Go.

What transport modes are supported?

Three modes: stdio (default for CLI integration), sse (Server-Sent Events over HTTP), and http (Streamable HTTP). Configure via the MCP_SERVER_MODE environment variable.

How can I authenticate to my VictoriaMetrics instance?

Use the VM_INSTANCE_BEARER_TOKEN environment variable for a bearer token, or provide custom HTTP headers via VM_INSTANCE_HEADERS. For VictoriaMetrics Cloud, use VMC_API_KEY.

Can I use it with VictoriaMetrics Cloud?

Yes. Set the VMC_API_KEY environment variable with an API key from the VictoriaMetrics Cloud Console. No VM_INSTANCE_ENTRYPOINT is needed when using VMC_API_KEY.

Does the server support write operations?

No. The server exposes only read‑only VictoriaMetrics APIs—the same functions available in VMUI. It does not support writing or modifying data.

其他分类下的更多 MCP 服务器

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K