mcp-victorialogs

概述

这是一个完全功能的 MCP 服务器，将 VictoriaLogs 与 AI 模型和工具桥接。它实现了模型上下文协议规范，允许与 VictoriaLogs API 无缝集成。服务器提供用于查询日志、探索数据、显示实例参数、列出流/字段以及查询统计信息的工具。它支持多种模式，包括 stdio、SSE 和 HTTP，具有全面的配置选项和内置文档搜索功能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• query_logsquery_logs(query: string, start_time?: string, end_time?: string, step?: string) -> object

  Query logs from VictoriaLogs with optional time range and step parameters

  试试:Show me error logs from the last hour试试:Query logs with keyword authentication failure
• show_parametersshow_parameters() -> object

  Show parameters of the VictoriaLogs instance

  试试:What are the current configuration parameters?试试:Show me VictoriaLogs instance settings
• list_streamslist_streams() -> object

  List available streams in VictoriaLogs

  试试:What log streams are available?试试:List all streams in the system
• list_fieldslist_fields(stream?: string) -> object

  List available fields in specified stream or all streams

  试试:What fields are available in the nginx stream?试试:Show all fields across all streams
• list_field_valueslist_field_values(field: string, stream?: string) -> object

  List values for a specific field in a stream

  试试:What are the possible values for the status field?试试:Show distinct values of the response_code field
• query_statsquery_stats(query: string, start_time?: string, end_time?: string) -> object

  Query statistics for logs as metrics

  试试:Show me query statistics for the last 24 hours试试:Get metrics for failed API calls
• search_docssearch_docs(query: string) -> object

  Search embedded VictoriaLogs documentation

  试试:How do I set up alerts in VictoriaLogs?试试:Search for information about log retention policies

可对比工具

安装

go install github.com/VictoriaMetrics/mcp-victorialogs/cmd/mcp-victorialogs@latest

docker run -d --name mcp-victorialogs \
  -e VL_INSTANCE_ENTRYPOINT=https://your-victorialogs-url \
  -e MCP_SERVER_MODE=http \
  -e MCP_LISTEN_ADDR=:8081 \
  -p 8081:8081 \
  ghcr.io/victoriametrics/mcp-victorialogs

{
  "mcpServers": {
    "victorialogs": {
      "command": "mcp-victorialogs",
      "args": ["--env", "VL_INSTANCE_ENTRYPOINT=https://your-victorialogs-url"]
    }
  }
}

FAQ

支持哪些 VictoriaLogs API？

MCP 服务器支持 VictoriaLogs 几乎所有只读 API，包括 Web UI 中可用的查询功能。

有哪些传输模式可用？

支持三种模式：stdio（默认）、SSE（服务器发送事件）和 HTTP（可流式 HTTP）。

mcp-victorialogs 对比