victoriametrics/mcp-victorialogs

部署与 DevOps

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

107 stars 31 forks 质量 89 趋势 35Apache-2.0

Repository Install

victoriametrics/mcp-victorialogs 是从 https://github.com/victoriametrics/mcp-victorialogs. 导入的 MCP 服务器候选

概览

victoriametrics/mcp-victorialogs 是从 https://github.com/victoriametrics/mcp-victorialogs. 导入的 MCP 服务器候选

概述（AI 翻译）

VictoriaLogs 模型上下文协议（MCP）服务器的实现。

这为访问您的VictoriaLogs实例提供了访问权限，并实现与VictoriaLogs的API和文档无缝集成。它能为你的 VictoriaLogs 实例提供一个全面的日志、可观察性和调试任务界面，为工程师和工具提供先进的自动化和交互功能。

特色

该MCP服务器允许您使用VictoriaLogs几乎所有只读API，即Web界面中所有可用的功能：

查询日志和探索日志数据
显示你的VictoriaLogs实例参数
列出可用的流、字段、字段值
日志作为度量的查询统计数据
带有设置说明和工具检查的UI，仅在可流式HTTP模式下进行检查。

此外，MCP服务器内嵌了最新的文档，能够在无需在线访问的情况下进行搜索。

关于具体可用工具和提示的更多信息，请参阅使用部分。

你可以在提示中结合工具、文档搜索功能，并为你的VictoriaLogs实例设计出优秀的使用场景。

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

README

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

VictoriaLogs MCP Server

The implementation of Model Context Protocol (MCP) server for VictoriaLogs.

This provides access to your VictoriaLogs instance and seamless integration with VictoriaLogs APIs and documentation. It can give you a comprehensive interface for logs, observability, and debugging tasks related to your VictoriaLogs instances, enable advanced automation and interaction capabilities for engineers and tools.

Features

This MCP server allows you to use almost all read-only APIs of VictoriaLogs, i.e. all functions available in Web UI:

Querying logs and exploring logs data
Showing parameters of your VictoriaLogs instance
Listing available streams, fields, field values
Query statistics for the logs as metrics
UI with setup instructions and tools inspection on the root endpoint (only in Streamable HTTP mode)

In addition, the MCP server contains embedded up-to-date documentation and is able to search it without online access.

More details about the exact available tools and prompts can be found in the Usage section.

You can combine functionality of tools, docs search in your prompts and invent great usage scenarios for your VictoriaLogs instance. And please note the fact that 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.

You can also combine the MCP server with other observability or doc search related MCP Servers and get even more powerful results.

Try without installation

There is a publicly available instance of the VictoriaMetrics MCP Server that you can use to test the features without installing it:

在 GitHub 查看完整 README

安装

docker run -i --rm -e VL_INSTANCE_ENTRYPOINT -e VL_INSTANCE_BEARER_TOKEN -e VL_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victorialogs

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>",
        "VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}