适合谁
- 使用 VictoriaMetrics 进行监控和可观测性工程的开发者和 SRE。
- 希望利用 AI 助手简化指标查询和运维任务的工程师。
- 需要快速查询文档和故障排除的团队。
V
VictoriaMetrics MCP Server
官方
VictoriaMetrics 官方 MCP 服务器，提供与 VictoriaMetrics API 和文档的无缝集成。
GitHub 源仓库 ↗
69FMRS · C
VictoriaMetrics MCP Server 是官方维护的高质量服务器，提供了丰富的工具集和文档搜索功能，适合监控场景。安装配置相对简单，但需要注意资源消耗和 API 权限管理。
VictoriaMetrics MCP Server 是 VictoriaMetrics 官方实现的 Model Context Protocol (MCP) 服务器，旨在为 AI 助手提供与 VictoriaMetrics 实例交互的能力。它允许通过自然语言查询指标、探索数据、分析告警规则、调试 relabel 配置等，并内置了 VictoriaMetrics 文档的向量数据库，支持离线搜索。该服务器支持多种传输模式（stdio、SSE、Streamable HTTP），并可通过环境变量灵活配置。
工具能力
query
执行即时 PromQL/MetricsQL 查询
query_range
在一段时间内执行范围 PromQL/MetricsQL 查询
metrics
列出可用的指标
metrics_metadata
获取存储的指标元数据（类型、帮助、单位）
labels
列出可用的标签名
label_values
列出特定标签的值
series
列出可用的时间序列
export
导出原始时间序列数据为 JSON 或 CSV（默认禁用）
rules
查看告警和记录规则
alerts
查看当前告警（触发中和待处理）
flags
查看 VictoriaMetrics 实例的非默认标志（默认禁用）
metric_statistics
获取指标使用（在查询中）统计信息
active_queries
查看当前正在执行的查询
top_queries
查看最频繁或最慢的查询
tsdb_status
查看 TSDB 基数统计
tenants
列出多租户集群中的可用租户
documentation
在嵌入的 VictoriaMetrics 文档中搜索
metric_relabel_debug
调试 Prometheus 兼容的 relabeling 规则（默认禁用）
downsampling_filters_debug
调试下采样配置（默认禁用）
retention_filters_debug
调试保留过滤器配置（默认禁用）
prettify_query
格式化和美化 PromQL/MetricsQL 查询
explain_query
解析 PromQL/MetricsQL 查询并解释其工作原理
test_rules
使用 vmalert 工具对告警和记录规则进行单元测试（默认禁用）
deployments
列出 VictoriaMetrics Cloud 中可用的部署
cloud_providers
列出 VictoriaMetrics Cloud 中可用的云提供商
regions
列出 VictoriaMetrics Cloud 中可用的区域
tiers
列出 VictoriaMetrics Cloud 中可用的部署层级
access_tokens
列出 VictoriaMetrics Cloud 中可用的部署访问令牌
rule_filenames
列出 VictoriaMetrics Cloud 中可用的告警和记录规则文件名
rule_file
获取 VictoriaMetrics Cloud 中特定告警或记录规则文件的内容
安装接入
- 从 GitHub Releases 下载二进制文件，或使用 Docker 镜像：
docker run -d --name mcp-victoriametrics -e VM_INSTANCE_ENTRYPOINT=... -e VM_INSTANCE_TYPE=... -p 8080:8080 ghcr.io/victoriametrics/mcp-victoriametrics。 - 设置环境变量：
VM_INSTANCE_ENTRYPOINT（必填，VictoriaMetrics 实例的根 URL）和VM_INSTANCE_TYPE（必填，single 或 cluster）。可选：VM_INSTANCE_BEARER_TOKEN、VM_INSTANCE_HEADERS、VMC_API_KEY用于 Cloud。 - 在 MCP 客户端中配置服务器，指定命令路径和上述环境变量。例如，对于 Claude Desktop，编辑
claude_desktop_config.json。
选型与风险
不适合谁
- 未使用 VictoriaMetrics 的用户，该服务器不适用于其他监控系统。
- 需要写入或修改数据的场景，该服务器仅支持只读 API。
- 对资源消耗敏感的环境，因为服务器内置文档向量数据库可能增加内存和 CPU 使用。
所需权限
- 读取 VictoriaMetrics 实例 API 的权限（查询、列出指标、导出数据等）。
- 如果使用 Cloud 模式，需要访问 VictoriaMetrics Cloud API 密钥。
- 可能需要网络访问以连接 VictoriaMetrics 实例或 Cloud 服务。
风险与副作用
- 需要小心管理 API 令牌，避免泄露敏感数据。
- AI 生成的查询和配置可能存在错误，应验证后再用于生产环境。
- 服务器可能消耗较多资源，尤其是在加载文档向量数据库时；可通过禁用文档工具来节省资源。
常见排障
- 确保 `VM_INSTANCE_ENTRYPOINT` 是可访问的根 URL（如 http://localhost:8428），并且实例类型正确（single 或 cluster）。
- 检查环境变量是否正确设置，特别是认证令牌。
- 如果使用 Cloud 模式，确保 `VMC_API_KEY` 有效且具有所需权限。
- 查看服务器日志（`MCP_LOG_LEVEL` 可设置 debug）以获取错误详细信息。
- 在 SSE/HTTP 模式下，可使用 `/health/liveness` 和 `/health/readiness` 端点检查服务器状态。
使用场景
通过自然语言查询指标和探索数据，无需手动编写 PromQL。
分析告警和记录规则，调试 relabel 配置。
监控 VictoriaMetrics 实例状态，包括基数、查询统计和活动查询。
搜索官方文档和博客，快速获取故障排除信息。
与 VictoriaMetrics Cloud 集成，管理部署和访问令牌。
支持客户端
Claude Desktop完整支持
Cursor完整支持
Claude Code部分支持
Codex部分支持
Visual Studio Code完整支持
Zed完整支持
JetBrains IDEs部分支持
Windsurf完整支持