InfluxDB MCP Server

InfluxDB MCP-Server

Ein Model Context Protocol (MCP)-Server, der den Zugriff auf eine InfluxDB-Instanz mithilfe der InfluxDB OSS API v2 ermöglicht. Größtenteils mit Claude Code erstellt.

Merkmale

Dieser MCP-Server bietet:

• Ressourcen : Zugriff auf Organisations-, Bucket- und Messdaten
• Tools : Daten schreiben, Abfragen ausführen und Datenbankobjekte verwalten
• Eingabeaufforderungen : Vorlagen für allgemeine Flux-Abfragen und das Line Protocol-Format

Ressourcen

Der Server stellt die folgenden Ressourcen bereit:

1. Liste der Organisationen : influxdb://orgs
   • Zeigt alle Organisationen in der InfluxDB-Instanz an
2. Buckets-Liste : influxdb://buckets
   • Zeigt alle Buckets mit ihren Metadaten an
3. Bucket-Messungen : influxdb://bucket/{bucketName}/measurements
   • Listet alle Messungen innerhalb eines angegebenen Buckets auf
4. Abfragedaten : influxdb://query/{orgName}/{fluxQuery}
   • Führt eine Flux-Abfrage aus und gibt die Ergebnisse als Ressource zurück

Werkzeuge

Der Server bietet folgende Tools:

1. write-data : Schreibt Zeitreihendaten im Zeilenprotokollformat
   • Parameter: Organisation, Bucket, Daten, Präzision (optional)
2. query-data : Flux-Abfragen ausführen
   • Parameter: org, Abfrage
3. create-bucket : Einen neuen Bucket erstellen
   • Parameter: Name, OrgID, retentionPeriodSeconds (optional)
4. create-org : Eine neue Organisation erstellen
   • Parameter: Name, Beschreibung (optional)

Eingabeaufforderungen

Der Server bietet diese Eingabeaufforderungsvorlagen:

1. flux-query-examples : Allgemeine Flux-Abfragebeispiele
2. line-protocol-guide : Leitfaden zum Zeilenprotokollformat von InfluxDB

Konfiguration

Der Server benötigt diese Umgebungsvariablen:

• INFLUXDB_TOKEN (erforderlich): Authentifizierungstoken für die InfluxDB-API
• INFLUXDB_URL (optional): URL der InfluxDB-Instanz (standardmäßig http://localhost:8086 )
• INFLUXDB_ORG (optional): Standard-Organisationsname für bestimmte Vorgänge

Installation

Installation über Smithery

So installieren Sie den InfluxDB MCP-Server für Claude Desktop automatisch über Smithery :

Option 1: Mit npx ausführen (empfohlen)

Option 2: Global installieren

Option 3: Aus der Quelle

Integration mit Claude für Desktop

Fügen Sie den Server zu Ihrer claude_desktop_config.json hinzu:

Verwendung von npx (empfohlen)

Bei lokaler Installation

Codestruktur

Der Servercode ist in einer modularen Struktur organisiert:

• src/
  • index.js - Haupteinstiegspunkt des Servers
  • config/ - Konfigurationsbezogene Dateien
    • env.js - Handhabung von Umgebungsvariablen
  • utils/ - Hilfsfunktionen
    • influxClient.js – InfluxDB-API-Client
    • loggerConfig.js – Konsolen-Logger-Konfiguration
  • handlers/ - Ressourcen- und Tool-Handler
    • organizationsHandler.js – Auflistung der Organisationen
    • bucketsHandler.js – Buckets-Auflistung
    • measurementsHandler.js – Auflistung der Messungen
    • queryHandler.js - Abfrageausführung
    • writeDataTool.js – Tool zum Schreiben von Daten
    • queryDataTool.js - Abfragetool
    • createBucketTool.js – Tool zur Bucket-Erstellung
    • createOrgTool.js – Tool zur Organisationserstellung
  • prompts/ - Eingabeaufforderungsvorlagen
    • fluxQueryExamplesPrompt.js – Flux-Abfragebeispiele
    • lineProtocolGuidePrompt.js - Leitfaden zum Leitungsprotokoll

Diese Struktur ermöglicht eine bessere Wartbarkeit, einfachere Tests und eine klarere Trennung der Belange.

Testen

Das Repository umfasst umfassende Integrationstests, die:

• Starten Sie einen Docker-Container mit InfluxDB
• Füllen Sie es mit Beispieldaten
• Testen Sie alle MCP-Serverfunktionen

So führen Sie die Tests aus:

Lizenz

MIT