VictoriaMetrics-mcp-server

yincongcyincong/VictoriaMetrics-mcp-server

🔗 Latest commit:349f222

🕒 Updated:Sep 9, 2025, 01:05 PM

JavaScript

Monitoring

MCP Server for the VictoriaMetrics.

MCP Trust Score

Based on our comprehensive evaluation criteria

🤖 Evaluated by gemini-2.5-flashFix

Trust Score42/100

• Basic MCP protocol features implemented (12/40)
• Room for improvement in GitHub community
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

GitHub Metrics

Repository statistics and activity

⭐ GitHub Stars:7

👥 Contributors:3

📋 Total Issues:0

📦 Has Releases:No

🔧 Has CI/CD Pipeline:No

Configuration

Configuration example extracted from README.md for Claude Desktop and other clients.

🤖 Evaluated by gemini-2.5-flashFix

{
  "yincongcyincong-victoriametrics-mcp-server": {
    "command": "npx",
    "args": [
      "-y",
      "@yincongcyincong/victoriametrics-mcp-server"
    ],
    "env": {
      "VM_URL": "",
      "VM_SELECT_URL": "",
      "VM_INSERT_URL": ""
    }
  },
  "yincongcyincong-victoriametrics-mcp-server-debug": {
    "command": "node",
    "args": [
      "src/index.js"
    ],
    "env": {
      "VM_URL": "http://127.0.0.1:8428"
    }
  }
}

MCP Protocol Support

Implemented MCP protocol features

🤖 Evaluated by gemini-2.5-flashFix

Tools:✓

Prompts:✗

Resources:✗

Sampling:✗

Roots:✗

Logging:✗

STDIO Transport:✓

HTTP Transport:✗

OAuth2 Auth:✗

Dependencies

3 dependencies

Libraries and frameworks used by this MCP server

🤖 Evaluated by gemini-2.5-flashFix

Main

@modelcontextprotocol/sdk

node-fetch

Light

@types/node-fetch

README.md

VictoriaMetrics MCP Server

MCP Server for the VictoriaMetrics.

Installing via Smithery

To install VictoriaMetrics Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude

Debug

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 Tools API Documentation

1. `vm_data_write`

Description: Write data to the VictoriaMetrics database.

Input Parameters:

Parameter	Type	Description	Required
`metric`	`object`	Tags of the metric	✅
`values`	`number[]`	Array of metric values	✅
`timestamps`	`number[]`	Array of timestamps in Unix seconds	✅

2. `vm_prometheus_write`

Description: Import Prometheus exposition format data into VictoriaMetrics.

Input Parameters:

Parameter	Type	Description	Required
`data`	`string`	Metrics in Prometheus exposition format	✅

3. `vm_query_range`

Description: Query time series data over a specific time range.

Input Parameters:

Parameter	Type	Description	Required
`query`	`string`	PromQL expression	✅
`start`	`number`	Start timestamp in Unix seconds	⛔️
`end`	`number`	End timestamp in Unix seconds	⛔️
`step`	`string`	Query resolution step width (e.g., `10s`, `1m`)	⛔️

Only query is required; the other fields are optional.

4. `vm_query`

Description: Query the current value of a time series.

Input Parameters:

Parameter	Type	Description	Required
`query`	`string`	PromQL expression to evaluate	✅
`time`	`number`	Evaluation timestamp in Unix seconds	⛔️

5. `vm_labels`

Description: Get all unique label names.

Input Parameters: None

6. `vm_label_values`

Description: Get all unique values for a specific label.

Input Parameters:

Parameter	Type	Description	Required
`label`	`string`	Label name to get values for	✅

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/yincongcyincong/VictoriaMetrics-mcp-server)](https://archestra.ai/mcp-catalog/yincongcyincong__victoriametrics-mcp-server)

Edit This Server Add New MCP Server Report an Issue

README.md

VictoriaMetrics MCP Server

MCP Server for the VictoriaMetrics.

Installing via Smithery

To install VictoriaMetrics Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @yincongcyincong/victoriametrics-mcp-server --client claude

Debug

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 Tools API Documentation

1. `vm_data_write`

Description: Write data to the VictoriaMetrics database.

Input Parameters:

Parameter	Type	Description	Required
`metric`	`object`	Tags of the metric	✅
`values`	`number[]`	Array of metric values	✅
`timestamps`	`number[]`	Array of timestamps in Unix seconds	✅

2. `vm_prometheus_write`

Description: Import Prometheus exposition format data into VictoriaMetrics.

Input Parameters:

Parameter	Type	Description	Required
`data`	`string`	Metrics in Prometheus exposition format	✅

3. `vm_query_range`

Description: Query time series data over a specific time range.

Input Parameters:

Parameter	Type	Description	Required
`query`	`string`	PromQL expression	✅
`start`	`number`	Start timestamp in Unix seconds	⛔️
`end`	`number`	End timestamp in Unix seconds	⛔️
`step`	`string`	Query resolution step width (e.g., `10s`, `1m`)	⛔️

Only query is required; the other fields are optional.

4. `vm_query`

Description: Query the current value of a time series.

Input Parameters:

Parameter	Type	Description	Required
`query`	`string`	PromQL expression to evaluate	✅
`time`	`number`	Evaluation timestamp in Unix seconds	⛔️

5. `vm_labels`

Description: Get all unique label names.

Input Parameters: None

6. `vm_label_values`

Description: Get all unique values for a specific label.

Input Parameters:

Parameter	Type	Description	Required
`label`	`string`	Label name to get values for	✅

VictoriaMetrics-mcp-server

Main

Light

VictoriaMetrics MCP Server

Installing via Smithery

Debug

NPX

📊 VictoriaMetrics Tools API Documentation

1. vm_data_write

2. vm_prometheus_write

3. vm_query_range

4. vm_query

5. vm_labels

6. vm_label_values

VictoriaMetrics MCP Server

Installing via Smithery

Debug

NPX

📊 VictoriaMetrics Tools API Documentation

1. vm_data_write

2. vm_prometheus_write

3. vm_query_range

4. vm_query

5. vm_labels

6. vm_label_values

1. `vm_data_write`

2. `vm_prometheus_write`

3. `vm_query_range`

4. `vm_query`

5. `vm_labels`

6. `vm_label_values`

1. `vm_data_write`

2. `vm_prometheus_write`

3. `vm_query_range`

4. `vm_query`

5. `vm_labels`

6. `vm_label_values`