victoriametrics/mcp-vmanomaly

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

11 stars 3 forks 质量 87 趋势 38Apache-2.0

Repository Install

The implementation of Model Context Protocol (MCP) server for VMAnomaly

概览

The implementation of Model Context Protocol (MCP) server for vmanomaly - VictoriaMetrics Anomaly Detection product. This provides seamless integration with vmanomaly REST API and documentation for AI-assisted anomaly detection, model management, and observability insights. This MCP server enables AI assistants like Claude to interact with vmanomaly for: - : Check vmanomaly server health and build information - : Discover UI-compatible models and validate univariate or multivariate configurations - : Profile sampled time series and run shared autotune suggestions for one production-ready model config across many returned series - : Generate complete vmanomaly YAML configurations - : Generate vmalert alerting rules based on anomaly score metrics to simplify alerting setup - : Full-text search across embedded vmanomaly documentation with fuzzy matching The MCP server contains embedded up-to-date vmanomaly documentation and is able to search it without online access.

README

以下为原文 README 节选，完整内容请查看原文。

MCP Server for vmanomaly

The implementation of Model Context Protocol (MCP) server for vmanomaly - VictoriaMetrics Anomaly Detection product.

This provides seamless integration with vmanomaly REST API and documentation for AI-assisted anomaly detection, model management, and observability insights.

Features

This MCP server enables AI assistants like Claude to interact with vmanomaly for:

Health Monitoring: Check vmanomaly server health and build information
Model Management: Discover UI-compatible models and validate univariate or multivariate configurations
Data-Driven Recommendations: Profile sampled time series and run shared autotune suggestions for one production-ready model config across many returned series
Configuration Generation: Generate complete vmanomaly YAML configurations
Alert Rule Generation: Generate vmalert alerting rules based on anomaly score metrics to simplify alerting setup
Documentation Search: Full-text search across embedded vmanomaly documentation with fuzzy matching

The MCP server contains embedded up-to-date vmanomaly documentation and is able to search it without online access.

The quality of the MCP Server and its responses depends very much on the capabilities of your client and the quality of the model you are using.

Requirements

vmanomaly instance with REST API access:
- version 1.28.3+ for the core MCP toolset
- version 1.30.0+ for time-series characteristics and task-based shared autotune
- version 1.30.5+ for named-query shared autotune and query-policy suggestions in VMUI

在 GitHub 查看完整 README

安装

docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_HEADERS ghcr.io/victoriametrics/mcp-vmanomaly

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "vmanomaly": {
      "command": "/path/to/mcp-vmanomaly",
      "env": {
        "VMANOMALY_ENDPOINT": "http://localhost:8490",
        "VMANOMALY_BEARER_TOKEN": "<YOUR_TOKEN>",
        "VMANOMALY_HEADERS": "X-Custom=value1,X-Auth=value2"
      }
    }
  }
}