Victoriametrics MCP Server

VictoriaMetrics的MCP服務，提供數據寫入、查詢和標籤管理功能

監控數據庫 #時序數據庫 #數據寫入 #數據查詢 #標籤管理 .JavaScript

評分 : 2.5分

下載量 : 14

更新時間 : 2025-04-29

什麼是VictoriaMetrics MCP Server?

VictoriaMetrics MCP Server是一箇中間件服務，提供了標準化的接口來與VictoriaMetrics時間序列數據庫進行交互。它簡化了數據寫入、查詢和管理的流程，使開發者能夠更輕鬆地集成監控數據到他們的應用中。

如何使用VictoriaMetrics MCP Server?

通過簡單的命令行工具或配置即可啟動服務，然後使用提供的API端點進行數據操作。服務支持多種數據格式和查詢方式。

適用場景

適用於需要監控系統指標、業務指標或任何時間序列數據的應用場景，特別是當需要與VictoriaMetrics數據庫交互時。

主要功能

數據寫入支持多種格式的數據寫入VictoriaMetrics數據庫

時間範圍查詢支持按時間範圍查詢時間序列數據

Prometheus兼容支持Prometheus格式的數據導入和查詢

標籤操作提供標籤名稱和值的查詢功能

優勢與侷限性

優勢

簡化了VictoriaMetrics的集成流程

提供統一的API接口

支持多種數據格式

輕量級且易於部署

侷限性

功能相對基礎，高級功能需要直接使用VictoriaMetrics API

性能可能不如直接使用VictoriaMetrics原生接口

如何使用

安裝與啟動

使用NPX快速啟動服務

配置環境變量

設置VictoriaMetrics的連接URL

使用API

通過HTTP請求調用各種API功能

使用案例

寫入監控數據將應用性能指標寫入數據庫

查詢CPU使用率查詢過去1小時的CPU使用率

常見問題

如何設置VictoriaMetrics的連接URL?

支持哪些數據寫入格式?

查詢性能如何?

🚀 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），可選 |