yincongcyincong
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"victoriametrics": {
"args": [
"-y",
"@yincongcyincong/victoriametrics-mcp-server"
],
"command": "npx",
"env": {
"VM_INSERT_URL": "",
"VM_SELECT_URL": "",
"VM_URL": ""
}
}
}
}可用工具 （6 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
vm_data_write
Write data to the VM database
该工具无需必填参数，直接调用即可
vm_query_range
Query time series over a time range
该工具无需必填参数，直接调用即可
vm_query
Query current value of a time series
该工具无需必填参数，直接调用即可
vm_labels
Get all unique label names
该工具无需必填参数，直接调用即可
vm_label_values
Get all unique values for a specific label
该工具无需必填参数，直接调用即可
vm_prometheus_write
mport Prometheus exposition format data into VictoriaMetrics
该工具无需必填参数，直接调用即可
服务介绍
VictoriaMetrics MCP 服务器
VictoriaMetrics 的 MCP 服务器。
通过 Smithery 安装
要通过 Smithery 自动安装适用于 Claude 桌面版的 VictoriaMetrics 服务器：
bash
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
json
{
"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 |
要获取值的标签名称 | ✅ |
