VictoriaMetrics MCP Server

VictoriaMetrics 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 データベースにデータを書き込みます。

入力パラメーター：

パラメーター	型	説明	必須
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	値を取得するラベル名	✅

---