mcp-victoriametrics 是 VictoriaMetrics 的 Model Context Protocol（MCP）服务器实现。它为 AI 客户端提供访问 VictoriaMetrics 实例的能力，并与 VictoriaMetrics API 和文档无缝集成，可用于监控、可观测性和调试任务，为工程师和工具提供自动化与交互能力。
主要能力 该 MCP 服务器允许使用 VictoriaMetrics 几乎所有的只读 API，即 VMUI 中可用的所有功能，包括：
- 查询指标和探索数据（如果客户端支持，甚至可以绘制图表）
- 列出并导出可用指标、标签、标签值和整个序列
- 分析和测试告警与记录规则及告警
- 显示 VictoriaMetrics 实例参数
- 探索数据基数和指标使用统计
- 分析、追踪、美化和解释查询
- 调试重标记规则、降采样和保留策略配置
- 与 VictoriaMetrics Cloud 集成
- 在根端点提供带设置说明和工具检查的 UI（仅在 Streamable HTTP 模式下） 此外，MCP 服务器包含嵌入式的最新文档，无需在线访问即可搜索。
使用方式 MCP 服务器通过环境变量配置。连接 VictoriaMetrics 实例有两种方式：
- 使用 VM_INSTANCE_ENTRYPOINT + VM_INSTANCE_TYPE + VM_INSTANCE_BEARER_TOKEN（可选）环境变量连接任意单节点或集群实例。
- 使用 VMC_API_KEY 环境变量连接 VictoriaMetrics Cloud 实例。
支持以下运行模式（传输方式）：
- stdio：标准输入/输出模式，默认模式，适合本地服务器。
- sse：Server-Sent Events，服务器暴露 /sse 和 /message 端点。
- http：Streamable HTTP，服务器暴露 /mcp 端点。
安装方式
- 下载最新发行版并放入 PATH。
- 使用 Docker（需替换环境变量，设置 MCP_SERVER_MODE=http 启用 Streamable HTTP 模式，镜像见 GitHub 容器注册表）。
- 从源码构建：克隆仓库 git clone https://github.com/VictoriaMetrics/mcp-victoriametrics.git，进入目录后运行 make build 或 docker build -t mcp-victoriametrics .。
- 使用 Helm chart（详见文档）。
客户端配置 支持在 Cursor、Claude Desktop、Claude Code、Codex CLI、Visual Studio Code、Zed、Windsurf 等客户端中配置。stdio 模式下可直接运行二进制，也可用 Docker 替代。配置示例中需填入实例参数。
可用工具与提示 提供大量与 VictoriaMetrics 实例交互的工具，以及针对 VictoriaMetrics Cloud 用户的额外工具（需 VMC_API_KEY）。服务器还包含预定义提示，用于常见任务。
适用场景 适合需要以自然语言与 VictoriaMetrics 交互的工程师，用于查询指标、分析规则、调试配置、探索数据基数等，并可与其他可观测性或文档搜索相关的 MCP 服务器组合使用，以获得更强大的结果。
限制 MCP 服务器和响应的质量很大程度上取决于客户端的能力和所用模型的质量。使用前需准备 VictoriaMetrics 或 VictoriaMetrics Cloud 实例（单节点或集群）。若从源码构建，需要 Go 1.26 或更高版本。
