mcpField
V
VictoriaMetrics MCP Server

VictoriaMetrics MCP Server

本地服务
github.com/yincongcyincong数据与分析83 周前更新
代码仓库

关于 VictoriaMetrics MCP Server

VictoriaMetrics MCP Server 将 VictoriaMetrics 的指标写入和查询操作提供给 MCP 客户端，适用于需要分析时间序列数据的场景。它支持 Prometheus 格式导入、PromQL 查询及标签检索。

主要功能

  1. 01写入指标数据
  2. 02导入 Prometheus 格式数据
  3. 03按时间范围查询时间序列
  4. 04查询当前时间序列值
  5. 05获取标签名和标签值

适用场景

  1. 01向 VictoriaMetrics 写入指标
  2. 02导入 Prometheus 暴露格式指标
  3. 03用 PromQL 分析时间范围内的数据
  4. 04查看指标的标签及其取值

MCP 相关

该 MCP 服务向客户端暴露 VictoriaMetrics 的数据写入、查询和标签检索工具。

#metrics#mcp#victoriametrics#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "VictoriaMetrics": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MseeP.ai 安全评估徽章

VictoriaMetrics MCP 服务

信任评分 smithery 徽章

VictoriaMetrics-mcp-server MCP 服务

VictoriaMetrics 的 MCP 服务。

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 VictoriaMetrics Server：

npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude

调试

npx @modelcontextprotocol/inspector -e VM_URL=http://127.0.0.1:8428  node src/index.js
NPX
{
    "mcpServers": {
        "victoriametrics": {
            "command": "npx",
            "args": [
                "-y",
                "@yincongcyincong/victoriametrics-mcp-server"
            ],
            "env": {
                "VM_URL": "",
                "VM_SELECT_URL": "",
                "VM_INSERT_URL": ""
            }
        }
    }
}
📊 VictoriaMetrics 工具 API 文档

1. vm_data_write

描述：向 VictoriaMetrics 数据库写入数据。

输入参数：

参数类型描述必需
metricobject指标的标签✅
valuesnumber[]指标值数组✅
timestampsnumber[]Unix 秒级时间戳数组✅

2. vm_prometheus_write

描述：将 Prometheus exposition format 格式的数据导入 VictoriaMetrics。

输入参数：

参数类型描述必需
datastringPrometheus exposition format 格式的指标✅

3. vm_query_range

描述：查询特定时间范围内的时间序列数据。

输入参数：

参数类型描述必需
querystringPromQL 表达式✅
startnumberUnix 秒级起始时间戳⛔️
endnumberUnix 秒级结束时间戳⛔️
stepstring查询分辨率步长（例如 10s、1m）⛔️

只有 query 是必需的；其他字段均为可选项。

4. vm_query

描述：查询时间序列的当前值。

输入参数：

参数类型描述必需
querystring要执行的 PromQL 表达式✅
timenumberUnix 秒级评估时间戳⛔️

5. vm_labels

描述：获取所有唯一标签名称。

输入参数：无

6. vm_label_values

描述：获取特定标签的所有唯一值。

输入参数：

参数类型描述必需
labelstring要获取其值的标签名称✅

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。