VictoriaLogs MCP-Server

Neuste Veröffentlichung Schmiedeabzeichen Lizenz Locker Reddit

Die Implementierung des Model Context Protocol (MCP) -Servers für VictoriaLogs .

Dies ermöglicht den Zugriff auf Ihre VictoriaLogs-Instanz und die nahtlose Integration mit den APIs und der Dokumentation von VictoriaLogs . Es bietet Ihnen eine umfassende Schnittstelle für Protokolle, Beobachtungs- und Debugging-Aufgaben im Zusammenhang mit Ihren VictoriaLogs-Instanzen und ermöglicht erweiterte Automatisierungs- und Interaktionsfunktionen für Ingenieure und Tools.

Merkmale

Mit diesem MCP-Server können Sie fast alle schreibgeschützten APIs von VictoriaLogs verwenden, d. h. alle in der Web-Benutzeroberfläche verfügbaren Funktionen:

Abfragen von Protokollen und Untersuchen von Protokolldaten
Parameter Ihrer VictoriaLogs-Instanz werden angezeigt
Auflisten verfügbarer Streams, Felder und Feldwerte
Abfragestatistiken für die Protokolle als Metriken

Darüber hinaus enthält der MCP-Server eingebettete aktuelle Dokumentationen und kann diese ohne Online-Zugriff durchsuchen.

Weitere Einzelheiten zu den genau verfügbaren Tools und Eingabeaufforderungen finden Sie im Abschnitt „Verwendung“ .

Sie können die Funktionalität von Tools und Dokumenten in Ihren Eingabeaufforderungen kombinieren und großartige Anwendungsszenarien für Ihre VictoriaLogs-Instanz entwickeln. Beachten Sie bitte, dass die Qualität des MCP-Servers und seiner Antworten stark von den Fähigkeiten Ihres Clients und der Qualität des verwendeten Modells abhängt.

Sie können den MCP-Server auch mit anderen MCP-Servern für Observability oder Dokumentensuche kombinieren und so noch leistungsfähigere Ergebnisse erzielen.

Anforderungen

VictoriaLogs- Instanz ( Einzelknoten oder Cluster )
Go 1.24 oder höher (wenn Sie aus der Quelle erstellen möchten)

Installation

Gehen

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

Quellcode

git clone https://github.com/VictoriaMetrics-Community/mcp-victorialogs.git cd mcp-victorialogs go build -o bin/mcp-victorialogs ./cmd/mcp-victorialogs/main.go # after that add bin/mcp-victorialogs file to your PATH

Binärdateien

Laden Sie einfach die neueste Version von der Seite „Releases “ herunter und fügen Sie sie in Ihren PATH ein.

Docker

Demnächst verfügbar...

Schmiedekunst

Um den VictoriaLogs MCP-Server für Ihren Client automatisch über Smithery zu installieren, können Sie die folgenden Befehle verwenden:

# Get the list of supported MCP clients npx -y @smithery/cli list clients #Available clients: # claude # cline # windsurf # roocode # witsy # enconvo # cursor # vscode # vscode-insiders # boltai # amazon-bedrock # Install VictoriaLogs MCP server for your client npx -y @smithery/cli install @VictoriaMetrics-Community/mcp-victorialogs --client <YOUR-CLIENT-NAME> # and follow the instructions

Konfiguration

Der MCP-Server für VictoriaLogs wird über Umgebungsvariablen konfiguriert:

Variable	Beschreibung	Erforderlich	Standard	Zulässige Werte
`VL_INSTANCE_ENTRYPOINT`	URL zur VictoriaLogs-Instanz	Ja	-	-
`VL_INSTANCE_BEARER_TOKEN`	Authentifizierungstoken für die VictoriaLogs-API	NEIN	-	-
`MCP_SERVER_MODE`	Serverbetriebsmodus	NEIN	`stdio`	`stdio` , `sse`
`MCP_SSE_ADDR`	Adresse, auf der der SSE-Server lauschen soll	NEIN	`:8081`	-

Konfigurationsbeispiele

# For a public playground export VL_INSTANCE_ENTRYPOINT="https://play-vmlogs.victoriametrics.com" # Server mode export MCP_SERVER_MODE="sse" export MCP_SSE_ADDR="0.0.0.0:8081"

Einrichtung in Clients

Cursor

Gehen Sie zu: Settings -> Cursor Settings -> MCP -> Add new global MCP server und fügen Sie die folgende Konfiguration in Ihre Cursordatei ~/.cursor/mcp.json ein:

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

Weitere Informationen finden Sie in den Cursor MCP-Dokumenten .

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Datei claude_desktop_config.json hinzu (Sie finden es, wenn Sie Settings -> Developer -> Edit config bearbeiten öffnen):

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

Weitere Informationen finden Sie in den Claude Desktop MCP-Dokumenten .

Claude Code

Führen Sie den folgenden Befehl aus:

claude mcp add victorialogs -- /path/to/mcp-victorialogs \ -e VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> \ -e VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN>

Weitere Informationen finden Sie in den MCP-Dokumenten von Claude Code .

Visual Studio Code

Fügen Sie dies zu Ihrer VS Code MCP-Konfigurationsdatei hinzu:

{ "servers": { "victorialogs": { "type": "stdio", "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Weitere Informationen finden Sie in den VS Code MCP-Dokumenten .

Zed

Fügen Sie Ihrer Zed-Konfigurationsdatei Folgendes hinzu:

"context_servers": { "victorialogs": { "command": { "path": "/path/to/mcp-victorialogs", "args": [], "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } }, "settings": {} } } }

Weitere Informationen finden Sie in den Zed MCP-Dokumenten .

JetBrains IDEs

Öffnen Sie Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP) .
Klicken Sie Add (+)
As JSON auswählen
Tragen Sie in das Eingabefeld Folgendes ein:

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

Windsurf

Fügen Sie Ihrer Windsurf MCP-Konfigurationsdatei Folgendes hinzu.

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

Weitere Informationen finden Sie in den Windsurf MCP-Dokumenten .

Amazon Bedrock

Demnächst verfügbar...

Verwenden von Docker anstelle von Binärdateien

Demnächst verfügbar...

Verwendung

Nachdem Sie den MCP-Server installiert und konfiguriert haben, können Sie ihn mit Ihrem bevorzugten MCP-Client verwenden.

Sie können den Dialog mit dem KI-Assistenten mit folgendem Satz starten:

Use MCP VictoriaLogs in the following answers

Dies ist jedoch nicht erforderlich. Sie können einfach anfangen, Fragen zu stellen, und der Assistent verwendet automatisch die Tools und die Dokumentation, um Ihnen die besten Antworten zu liefern.

Werkzeugsatz

MCP VictoriaLogs bietet zahlreiche Tools für die Interaktion mit Ihrer VictoriaLogs-Instanz.

Hier ist eine Liste der verfügbaren Tools:

Werkzeug	Beschreibung
`documentation`	Suche in der eingebetteten VictoriaLogs-Dokumentation
`facets`	Häufigste Werte pro Protokollfeld
`field_names`	Liste der Feldnamen für die Abfrage
`field_values`	Liste der Feldwerte für die Abfrage
`flags`	Nicht standardmäßige Flags der VictoriaLogs-Instanz anzeigen
`hits`	Die Anzahl der übereinstimmenden Protokolleinträge, gruppiert nach Buckets
`query`	Ausführen von LogsQL-Abfragen
`stats_query`	Abfragen der Protokollstatistiken für die angegebene Zeit
`stats_query_range`	Abfragen von Protokollstatistiken für den angegebenen Zeitraum
`stream_field_names`	Liste der Streamfelder für die Abfrage
`stream_field_names`	Liste der Stream-Feldwerte für die Abfrage
`stream_ids`	Liste der Stream-IDs für die Abfrage
`streams`	Liste der Streams für die Abfrage

Eingabeaufforderungen

Der Server enthält vordefinierte Eingabeaufforderungen für allgemeine Aufgaben.

Dies sind im Moment nur Beispiele, die Prompt-Bibliothek wird in Zukunft erweitert:

Prompt	Beschreibung
`documentation`	Durchsuchen Sie die VictoriaLogs-Dokumentation nach bestimmten Themen

Haftungsausschluss

KI-Dienste und -Agenten sowie MCP-Server wie dieser können die Genauigkeit, Vollständigkeit und Zuverlässigkeit der Ergebnisse nicht garantieren. Sie sollten die mit KI erzielten Ergebnisse überprüfen. Die Qualität des MCP-Servers und seiner Antworten hängt stark von den Fähigkeiten Ihres Clients und der Qualität des verwendeten Modells ab.

Beitragen

Beiträge zum MCP VictoriaLogs-Projekt sind willkommen! Senden Sie uns gerne Probleme, Funktionswünsche oder Pull Requests.

mcp-victorialogs

VictoriaLogs MCP-Server

Merkmale

Anforderungen

Installation

Gehen

Quellcode

Binärdateien

Docker

Schmiedekunst

Konfiguration

Konfigurationsbeispiele

Einrichtung in Clients

Cursor

Claude Desktop

Claude Code

Visual Studio Code

Zed

JetBrains IDEs

Windsurf

Amazon Bedrock

Verwenden von Docker anstelle von Binärdateien

Verwendung

Werkzeugsatz

Eingabeaufforderungen

Haftungsausschluss

Beitragen

Related Resources

New MCP Servers

MCP directory API