【技术文档摘要】：

VictoriaMetrics MCP 服务器

VictoriaMetrics 的 MCP 服务器。

通过 Smithery 安装

要通过 Smithery 自动安装 VictoriaMetrics 服务器到 Claude Desktop：

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 数据库。

输入参数：

参数	类型	描述	必填
metric	object	指标的标签	✅
values	number[]	指标值数组	✅
timestamps	number[]	Unix 时间戳数组	✅

---

2. vm_prometheus_write

描述：将 Prometheus 展示格式的数据导入 VictoriaMetrics。

输入参数：

参数	类型	描述	必填
data	string	Prometheus 展示格式的指标数据	✅

---

3. vm_query_range

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

输入参数：

参数	类型	描述	必填
query	string	PromQL 表达式	✅
start	number	开始时间戳（Unix 秒）	⛔️
end	number	结束时间戳（Unix 秒）	⛔️
step	string	查询分辨率步长（例如，10s，1m）	⛔️

只需填写 query，其他字段可选。

---

4. vm_query

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

输入参数：

参数	类型	描述	必填
query	string	需要评估的 PromQL 表达式	✅
time	number	评估时间戳（Unix 秒）	⛔️

---

5. vm_labels

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

输入参数：无

---

6. vm_label_values

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

输入参数：

参数	类型	描述	必填
label	string	获取值的标签名称	✅

---