← 返回目录

VictoriaMetrics MCP Server

官方

VictoriaMetrics 官方 MCP 服务器，提供与 VictoriaMetrics API 和文档的无缝集成。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 16 / 438
Stars: ★ 237 非常热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: 预编译二进制 · Docker · Go 1.26+ · 远程托管（无需本地环境）
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 11 天前
工具数: 30

69FMRS · C

VictoriaMetrics MCP Server 是官方维护的高质量服务器，提供了丰富的工具集和文档搜索功能，适合监控场景。安装配置相对简单，但需要注意资源消耗和 API 权限管理。

最强项 · 维护活跃度 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

15/20

维护活跃度

16/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 源码提供清晰的初始化流程和工具列表，但未看到可验证的测试或CI演示关键路径，因此不确定实际启动和工具行为是否完全一致。错误处理和依赖控制有一定文档支持，但静态审查无法确认。
安全与权限 15/20: 凭据通过环境变量管理，并标记为机密，未在示例中硬编码真实令牌。工具以只读操作为主，未发现破坏性默认操作。但权限最小化、数据流披露和危险操作确认机制未在源码中完全体现，故扣分。
维护活跃度 16/20: 仓库活跃，有持续提交和发布，许可证为Apache-2.0。但未评估问题响应速度和依赖更新策略，安全响应渠道未明确说明。
文档质量 15/20: README提供了详细的安装、配置、客户端设置和故障排查信息，工具和提示列表清晰。但缺少对工具参数、限制和成本的详细文档，部分假设未明确。
安装易用性 13/20: 安装步骤清晰，提供二进制、Docker、Helm和源码方式，且包含主流客户端配置示例。但静态审查未验证执行过程，且Docker和客户端配置示例略显复杂，故未给满分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 VictoriaMetrics 进行监控和可观测性工程的开发者和 SRE。
希望利用 AI 助手简化指标查询和运维任务的工程师。
需要快速查询文档和故障排除的团队。

不适合谁

未使用 VictoriaMetrics 的用户，该服务器不适用于其他监控系统。
需要写入或修改数据的场景，该服务器仅支持只读 API。
对资源消耗敏感的环境，因为服务器内置文档向量数据库可能增加内存和 CPU 使用。

所需权限

读取 VictoriaMetrics 实例 API 的权限（查询、列出指标、导出数据等）。
如果使用 Cloud 模式，需要访问 VictoriaMetrics Cloud API 密钥。
可能需要网络访问以连接 VictoriaMetrics 实例或 Cloud 服务。

风险与副作用

需要小心管理 API 令牌，避免泄露敏感数据。
AI 生成的查询和配置可能存在错误，应验证后再用于生产环境。
服务器可能消耗较多资源，尤其是在加载文档向量数据库时；可通过禁用文档工具来节省资源。

安装接入

准备工作

运行环境：预编译二进制 · Docker · Go 1.26+ · 远程托管（无需本地环境）

VM_INSTANCE_ENTRYPOINT 必填 VictoriaMetrics 实例的根 URL（vmsingle 或 vmselect），例如 http://localhost:8428。

VM_INSTANCE_TYPE 必填实例类型，取值为 single 或 cluster。

VM_INSTANCE_BEARER_TOKEN 可选密钥 VictoriaMetrics API 的认证 Bearer token，从实例的认证配置获取。

VMC_API_KEY 可选密钥 VictoriaMetrics Cloud 控制台生成的 API key，用于连接云端部署。

其他可选配置项（10 个）

VM_INSTANCE_HEADERS 可选随请求发送的自定义 HTTP 头，格式为逗号分隔的 key=value 对。

MCP_PASSTHROUGH_HEADERS 可选需要从 MCP 请求转发到 VictoriaMetrics 的 HTTP 头名称列表，仅在 sse/http 模式生效。

VM_DEFAULT_TENANT_ID 可选集群模式下的默认租户 ID，格式为 accountID 或 accountID:projectID。

MCP_SERVER_MODE 可选服务器运行模式：stdio（默认）、sse 或 http。

MCP_LISTEN_ADDR 可选 sse/http 模式的监听地址，默认 localhost:8080。

MCP_DISABLED_TOOLS 可选以逗号分隔的要禁用的工具列表，如 export,flags。

MCP_DISABLE_RESOURCES 可选设为 true 时禁用所有资源（documentation 工具仍可用）。

MCP_HEARTBEAT_INTERVAL 可选 streamable-http 模式的心跳间隔，默认 30s。

MCP_LOG_FORMAT 可选日志输出格式：text 或。

MCP_LOG_LEVEL 可选最低日志级别：debug、info、warn、error。

从 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。

验证是否装好

启动后在 MCP 客户端的工具列表中应出现 query、metrics、tenants 等工具；可询问「我的实例里有哪些租户？」，若能返回租户列表则说明连接成功。

常见排障

确保 `VM_INSTANCE_ENTRYPOINT` 是可访问的根 URL（如 http://localhost:8428），并且实例类型正确（single 或 cluster）。
检查环境变量是否正确设置，特别是认证令牌。
如果使用 Cloud 模式，确保 `VMC_API_KEY` 有效且具有所需权限。
查看服务器日志（`MCP_LOG_LEVEL` 可设置 debug）以获取错误详细信息。
在 SSE/HTTP 模式下，可使用 `/health/liveness` 和 `/health/readiness` 端点检查服务器状态。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我的 VictoriaMetrics 实例里有哪些租户？
列出当前可用的指标，并告诉我哪些指标从未被查询过（使用 metric_statistics）
帮我解释并格式化这条查询：rate(node_cpu_seconds_total[5m])
搜索文档说明 VictoriaMetrics 的降采样（downsampling）是如何工作的

工具能力 30

query 只读

执行即时 PromQL/MetricsQL 查询

query_range 只读

在一段时间内执行范围 PromQL/MetricsQL 查询

metrics 只读

列出可用的指标

metrics_metadata 只读

获取存储的指标元数据（类型、帮助、单位）

labels 只读

列出可用的标签名

label_values 只读

列出特定标签的值

series 只读

列出可用的时间序列

export 只读

导出原始时间序列数据为 JSON 或 CSV（默认禁用）

展开其余 22 个工具

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 中特定告警或记录规则文件的内容

使用场景

通过自然语言查询指标和探索数据，无需手动编写 PromQL。

分析告警和记录规则，调试 relabel 配置。

监控 VictoriaMetrics 实例状态，包括基数、查询统计和活动查询。

搜索官方文档和博客，快速获取故障排除信息。

与 VictoriaMetrics Cloud 集成，管理部署和访问令牌。

支持客户端

Claude Desktop

Cursor

Claude Code部分支持

Codex部分支持

VS Code

Zed

JetBrains IDEs部分支持

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

VictoriaMetrics MCP Server 是 VictoriaMetrics 官方实现的 Model Context Protocol (MCP) 服务器，旨在为 AI 助手提供与 VictoriaMetrics 实例交互的能力。它允许通过自然语言查询指标、探索数据、分析告警规则、调试 relabel 配置等，并内置了 VictoriaMetrics 文档的向量数据库，支持离线搜索。该服务器支持多种传输模式（stdio、SSE、Streamable HTTP），并可通过环境变量灵活配置。