这个项目能做什么

mcp-vmanomaly 是模型上下文协议（Model Context Protocol, MCP）服务器的开源实现，它将 AI 助手（如 Claude、Cursor、VS Code Copilot 等）与 VictoriaMetrics 异常检测（vmanomaly）连接起来。它公开了一组工具，使 AI 代理可以通过 REST API 与正在运行的 vmanomaly 实例交互，涵盖健康监控、模型发现与验证、YAML 配置生成、基于异常评分指标的 VMAlert 规则生成、时间序列分析、共享自动调优任务，以及带模糊匹配的全文文档搜索。 该服务器内置了最新版本的 vmanomaly 文档，因此文档搜索可在无网络访问的情况下离线工作。它支持三种传输模式：stdio（默认，用于本地单用户使用）、Streamable HTTP（暴露 /mcp）以及旧版 SSE 传输（暴露 /sse 和 /message）。配置完全由环境变量驱动，包括 vmanomaly 端点 URL、Bearer 令牌（或用于挂载密钥的令牌文件）、自定义 HTTP 头、请求超时、工具允许列表/拒绝列表、资源开关、心跳间隔以及日志级别/文件。服务器还公开了 Prometheus 格式的 /metrics、/health/liveness 和 /health/readiness 端点，用于运维监控。 安装选项包括 Go install、从 GitHub Releases 获取预构建二进制文件（支持校验和与构建来源证明验证）、从 ghcr.io 获取 Docker 镜像，以及从源码构建。提供了针对 Cursor、Claude Desktop、Claude Code、Visual Studio Code、Zed、JetBrains IDE 和 Windsurf 的客户端设置说明，每个都包含 JSON 配置片段。对于无法运行本地二进制的环境，还提供了基于 Docker 的客户端配置。 安全指南内容详尽：服务器使用进程级 Bearer 令牌转发请求，并且不实现按用户身份或租户隔离。文档建议在本地单用户场景下使用 stdio，对于远程 HTTP/SSE 访问使用经过身份验证的 TLS 反向代理（如 vmauth），使用最小权限的 vmanomaly 凭据，并强制执行工具允许列表/拒绝列表。文档明确警告不要将多个不受信任的域放置在单个静态 MCP 凭据之后，并建议将一个逻辑上的 vmanomaly 安装视为一个受信任的域。 工具集按类别组织：健康与信息（4 个工具）、模型配置（4 个工具）、配置验证（1 个工具）、文档搜索（1 个工具）、兼容性检查（1 个工具）、告警规则生成（1 个工具）以及分析与自动调优（4 个工具）。自动调优任务接受优化预算参数（试验次数、超时、高级 Optuna 参数），并为采样的时间序列返回可用于生产的模型配置建议。该服务器要求 vmanomaly 1.28.3+ 以使用核心工具集，1.30.0+ 以使用时间序列特征和基于任务的共享自动调优，1.30.5+ 以使用命名查询共享自动调优和 VMUI 中的查询策略建议。从源码构建需要 Go 1.24+。