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:

Liste der Organisationen : influxdb://orgs
- Zeigt alle Organisationen in der InfluxDB-Instanz an
Buckets-Liste : influxdb://buckets
- Zeigt alle Buckets mit ihren Metadaten an
Bucket-Messungen : influxdb://bucket/{bucketName}/measurements
- Listet alle Messungen innerhalb eines angegebenen Buckets auf
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:

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

Eingabeaufforderungen

Der Server bietet diese Eingabeaufforderungsvorlagen:

flux-query-examples : Allgemeine Flux-Abfragebeispiele
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 :

npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude

Option 1: Mit npx ausführen (empfohlen)

# Run directly with npx
INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

Option 2: Global installieren

# Install globally
npm install -g influxdb-mcp-server

# Run the server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

Option 3: Aus der Quelle

# Clone the repository
git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server

# Install dependencies
npm install

# Run the server
INFLUXDB_TOKEN=your_token npm start

Integration mit Claude für Desktop

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

Verwendung von npx (empfohlen)

{
  "mcpServers": {
    "influxdb": {
      "command": "npx",
      "args": ["influxdb-mcp-server"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Bei lokaler Installation

{
  "mcpServers": {
    "influxdb": {
      "command": "node",
      "args": ["/path/to/influxdb-mcp-server/src/index.js"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

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:

npm test

Lizenz

MIT

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Ein Model Context Protocol-Server, der Claude Zugriff auf InfluxDB-Zeitreihendatenbankinstanzen bietet und das Schreiben von Daten, Abfragen und Verwalten von Organisationen und Buckets in natürlicher Sprache ermöglicht.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MCP Database Server
dwarvesf
-
security
F
license
-
quality
A Model Context Protocol server that provides tools for interacting with databases, including PostgreSQL, DuckDB, and Google Cloud Storage Parquet files.
Last updated -
2
TypeScript
InfluxDB MCP Server
m4tyn0
-
security
F
license
-
quality
A Model Context Protocol server that provides secure, read-only access to time-series data stored in InfluxDB 1.8 via JWT authentication.
Last updated -
Python
MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License

View all related MCP servers

InfluxDB MCP Server