mcp-vmanomaly

mcp-vmanomaly es una implementación de código abierto de un servidor del Model Context Protocol (MCP) que conecta asistentes de IA (como Claude, Cursor, VS Code Copilot y otros) con VictoriaMetrics Anomaly Detection (vmanomaly). Expone un conjunto de herramientas que permiten a los agentes de IA interactuar con una instancia de vmanomaly en ejecución a través de su API REST, cubriendo monitoreo de salud, descubrimiento y validación de modelos, generación de configuración YAML, generación de reglas VMAlert a partir de métricas de puntuación de anomalías, perfilado de series temporales, tareas de autotune compartidas y búsqueda de documentación de texto completo con coincidencia difusa. El servidor incluye documentación de vmanomaly integrada y actualizada para que la búsqueda de documentación funcione sin conexión a Internet. Soporta tres modos de transporte: stdio (por defecto, para uso local de un solo usuario), Streamable HTTP (exponiendo /mcp) y el transporte SSE heredado (exponiendo /sse y /message). La configuración se realiza íntegramente mediante variables de entorno, incluyendo la URL del endpoint de vmanomaly, token portador (o archivo de token para secretos montados), cabeceras HTTP personalizadas, tiempo de espera de solicitudes, lista blanca/negra de herramientas, conmutadores de recursos, intervalo de latido y nivel/archivo de registro. El servidor también expone endpoints /metrics, /health/liveness y /health/readiness en formato Prometheus para monitoreo operativo. Las opciones de instalación incluyen Go install, binarios precompilados de GitHub Releases (con verificación de suma de comprobación y atestación de procedencia de compilación), imágenes Docker de ghcr.io y compilación desde el código fuente. Se proporcionan instrucciones de configuración de cliente para Cursor, Claude Desktop, Claude Code, Visual Studio Code, Zed, IDE de JetBrains y Windsurf, cada una con fragmentos de configuración JSON. También se incluye una configuración de cliente basada en Docker para entornos donde no es práctico ejecutar un binario local. La guía de seguridad es extensa: el servidor reenvía solicitudes utilizando un token portador a nivel de proceso y no implementa identidad por usuario ni aislamiento de inquilinos. La documentación recomienda stdio para uso local de un solo usuario, proxies inversos TLS autenticados (como vmauth) para acceso remoto HTTP/SSE, credenciales de vmanomaly con privilegios mínimos y aplicación de listas blancas/negras de herramientas. Advierte explícitamente contra colocar múltiples dominios no confiables detrás de una única credencial MCP estática y recomienda tratar una instalación lógica de vmanomaly como un dominio de confianza. El conjunto de herramientas se organiza en categorías: Salud e información (4 herramientas), Configuración de modelos (4 herramientas), Validación de configuración (1 herramienta), Búsqueda de documentación (1 herramienta), Comprobación de compatibilidad (1 herramienta), Generación de reglas de alerta (1 herramienta) y Análisis y autotune (4 herramientas). Las tareas de autotune aceptan parámetros de presupuesto de optimización (pruebas, tiempo de espera, parámetros avanzados de Optuna) y devuelven recomendaciones para configuraciones de modelos listas para producción en series temporales muestreadas. El servidor requiere vmanomaly 1.28.3+ para el conjunto de herramientas principal, 1.30.0+ para características de series temporales y autotune compartido basado en tareas, y 1.30.5+ para autotune compartido de consultas nombradas y sugerencias de políticas de consulta en VMUI. Se requiere Go 1.24+ para compilar desde el código fuente.