yincongcyincong/VictoriaMetrics-mcp-server

Overview

This JavaScript server implements the Model Context Protocol to expose VictoriaMetrics time series data to AI agents. It allows tools like Claude to query metrics using natural language or structured requests.

Best for

Best for
Developers who want to connect VictoriaMetrics to AI assistants via the Model Context Protocol

Use cases

• Query VictoriaMetrics metrics through AI chat interfaces
• Integrate monitoring data into AI-driven workflows and automation
• Enable natural language access to time series data for non-technical users

How to use

Install

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

Tools exposed

• vm_data_write
• vm_prometheus_write
• vm_query_range
• vm_query
• vm_labels
• vm_label_values

Tested with

Claude Desktop

Example client config

{\n    "mcpServers": {\n        "victoriametrics": {\n            "command": "npx",\n            "args": [\n                "-y",\n                "@yincongcyincong/victoriametrics-mcp-server"\n            ],\n            "env": {\n                "VM_URL": "",\n                "VM_SELECT_URL": "",\n                "VM_INSERT_URL": ""\n            }\n        }\n    }\n}

Notes

This JavaScript server implements the Model Context Protocol to expose VictoriaMetrics time series data to AI agents. It allows tools like Claude to query metrics using natural language or structured requests.

7 stars on GitHub. Last updated 2025-11-13.

Use cases

• Query VictoriaMetrics metrics through AI chat interfaces
• Integrate monitoring data into AI-driven workflows and automation
• Enable natural language access to time series data for non-technical users

Pros

• Lightweight JavaScript implementation with low overhead
• Connects VictoriaMetrics directly to MCP-compatible AI assistants
• Simple setup for developers already using VictoriaMetrics

Cons

• Very low community adoption with only 7 GitHub stars
• Limited documentation and examples beyond basic setup
• May lack advanced features found in more established integrations

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.