VictoriaMetrics-mcp-server

🚀 VictoriaMetrics MCP 服务器

VictoriaMetrics MCP 服务器提供了与 VictoriaMetrics 数据库交互的功能，支持数据写入、查询等操作，方便开发者进行调试和数据处理。

🚀 快速开始

调试

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": ""
            }
        }
    }
}

💻 使用示例

基础用法

# 调试命令示例
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 exposition 格式数据导入 VictoriaMetrics。
• 输入参数： | 属性 | 详情 | |------|------| | data | 类型为 string，Prometheus exposition 格式的指标数据，必填 |

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，要获取值的标签名称，必填 |