TDengine Query MCP Server

Ein Model Context Protocol (MCP)-Server, der schreibgeschützte TDengine-Datenbankabfragen für KI-Assistenten bereitstellt. Führen Sie Abfragen aus, erkunden Sie Datenbankstrukturen und untersuchen Sie Ihre Daten direkt aus Ihren KI-gestützten Tools.

Unterstützte KI-Tools

Dieser MCP-Server funktioniert mit jedem Tool, das das Model Context Protocol unterstützt, einschließlich:

• Cursor-IDE : Einrichten in .cursor/mcp.json

• Anthropic Claude : Verwendung mit einem kompatiblen MCP-Client

• Andere MCP-kompatible KI-Assistenten : Befolgen Sie die MCP-Konfigurationsanweisungen des Tools

Related MCP server: MCP MySQL App

Funktionen und Einschränkungen

Was es bewirkt

• ✅ Führen Sie schreibgeschützte TDengine-Abfragen aus (nur SELECT, SHOW, DESCRIBE)

• ✅ Bereitstellung von Datenbank-/Stabilinformationen und Metadaten

• ✅ Liste der verfügbaren Datenbanken und Ställe

Was es nicht tut

• ❌ Schreibvorgänge ausführen (INSERT, UPDATE, DELETE, CREATE, ALTER usw.)

• ❌ Bereitstellung von Funktionen für Datenbankdesign oder Schemagenerierung

• ❌ Funktioniert als vollwertiges Datenbankverwaltungstool

Dieses Tool ist speziell für die Datenuntersuchung und -exploration durch schreibgeschützte Abfragen konzipiert. Es ist nicht für die Datenbankverwaltung, Schemaverwaltung oder Datenänderung vorgesehen.

Anwendung

Vom Quellcode ausführen

Die empfohlene Vorgehensweise zur Verwendung dieses MCP-Servers besteht darin, ihn direkt mit uv ohne Installation auszuführen. So sind sowohl Claude Desktop als auch Cursor in den folgenden Beispielen für die Verwendung konfiguriert.

Wenn Sie das Repository klonen möchten:

Anschließend können Sie den Server direkt ausführen:

Alternativ können Sie die .env Datei im Verzeichnis src/tdengine_mcp_server/ ändern, um die Umgebungsvariablen festzulegen und den Server mit dem folgenden Befehl auszuführen:

Wichtig: Die .env-Datei hat eine höhere Priorität als die Befehlszeilenargumente.

Von Pypi mit pip -Befehl installieren

und führen Sie dann aus:

Installation mit dem uvx -Befehl

Installieren Sie von Smithery mit npx -Befehl

Sie können den Client nach der Option --client mit Alternativen wie claude , 'windsurf' usw. ändern. Sie können auch Folgendes verwenden: smithery/tdengine-mcp-server

Konfigurationsoptionen

.env-Datei

CLI-Nutzung

Integration mit KI-Assistenten

Ihr KI-Assistent kann über den MCP-Server mit TDengine-Datenbanken interagieren. Hier sind einige Beispiele:

Beispielabfragen:

Verwenden der TDengine MCP-Tools

Der TDengine Query MCP-Server bietet drei Haupttools, die Ihr KI-Assistent verwenden kann:

1. Abfrage

Führen Sie schreibgeschützte SQL-Abfragen für einen bestimmten stabilen Wert aus:

2. Informationen

Erhalten Sie detaillierte Informationen zu Ihrem Stall:

Sicherheitsüberlegungen

• ✅ Es sind nur schreibgeschützte Abfragen zulässig (AUSWÄHLEN, ANZEIGEN, BESCHREIBEN).

Fehlerbehebung

Verbindungsprobleme

Wenn Sie Verbindungsprobleme haben:

1. Überprüfen Sie Ihre Datenbankanmeldeinformationen in Ihrer MCP-Konfiguration

2. Stellen Sie sicher, dass der TDengine-Server läuft und zugänglich ist

3. Überprüfen Sie, ob Firewall-Regeln Verbindungen blockieren

4. Aktivieren Sie den Debug-Modus, indem Sie LOG_LEVEL in Ihrer Konfiguration festlegen

Häufige Fehler

Fehler: Abfrageausführung fehlgeschlagen

• Überprüfen Sie Ihre SQL-Syntax

• Stellen Sie sicher, dass Sie nur unterstützte Abfragetypen verwenden (SELECT, SHOW, DESCRIBE).

• Stellen Sie sicher, dass Ihre Abfrage wirklich schreibgeschützt ist

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Für weitere Informationen oder Support öffnen Sie bitte ein Problem im GitHub-Repository.