IoTDB MCP-Server

Name: IoTDB MCP Server
Author: apache

Schmiedeabzeichen

Überblick

Eine Model Context Protocol (MCP)-Serverimplementierung, die Datenbankinteraktion und Business Intelligence-Funktionen über IoTDB ermöglicht. Dieser Server ermöglicht die Ausführung von SQL-Abfragen.

Related MCP server: Microsoft SQL Server MCP Server

Komponenten

Ressourcen

Der Server stellt keine Ressourcen bereit.

Eingabeaufforderungen

Der Server gibt keine Eingabeaufforderungen aus.

Werkzeuge

Der Server bietet verschiedene Tools für das IoTDB-Baummodell und das Tabellenmodell. Sie können zwischen diesen wählen, indem Sie die Konfiguration "IOTDB_SQL_DIALECT" auf "Baum" oder "Tabelle" setzen.

Baummodell

metadata_query
- Führen Sie SHOW/COUNT-Abfragen aus, um Metadaten aus der Datenbank zu lesen
- Eingang:
  - query_sql (Zeichenfolge): Die auszuführende SHOW/COUNT-SQL-Abfrage
- Gibt zurück: Abfrageergebnisse als Array von Objekten
select_query
- Führen Sie SELECT-Abfragen aus, um Daten aus der Datenbank zu lesen
- Eingang:
  - query_sql (Zeichenfolge): Die auszuführende SELECT-SQL-Abfrage
- Gibt zurück: Abfrageergebnisse als Array von Objekten

Tabellenmodell

Abfragetools

read_query
- Führen Sie SELECT-Abfragen aus, um Daten aus der Datenbank zu lesen
- Eingang:
  - query (Zeichenfolge): Die auszuführende SELECT-SQL-Abfrage
- Gibt zurück: Abfrageergebnisse als Array von Objekten

Schema-Tools

list_tables
- Holen Sie sich eine Liste aller Tabellen in der Datenbank
- Keine Eingabe erforderlich
- Rückgabe: Array von Tabellennamen
describe-table
- Schemainformationen für eine bestimmte Tabelle anzeigen
- Eingang:
  - table_name (Zeichenfolge): Name der zu beschreibenden Tabelle
- Rückgabe: Array von Spaltendefinitionen mit Namen und Typen

Claude Desktop Integration

Voraussetzungen

Python mit uv -Paketmanager
IoTDB-Installation
MCP-Serverabhängigkeiten

Entwicklung

# Clone the repository git clone https://github.com/apache/iotdb-mcp-server.git cd iotdb_mcp_server # Create virtual environment uv venv source venv/bin/activate # or `venv\Scripts\activate` on Windows # Install development dependencies uv sync

Konfigurieren Sie den MCP-Server in der Konfigurationsdatei von Claude Desktop:

macOS

Speicherort: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Speicherort: %APPDATA%/Claude/claude_desktop_config.json

Möglicherweise müssen Sie den vollständigen Pfad zur UV-Programmdatei in das Befehlsfeld eingeben. Sie erhalten diesen, indem Sie

{ "mcpServers": { "iotdb": { "command": "uv", "args": [ "--directory", "YOUR_REPO_PATH/src/iotdb_mcp_server", "run", "server.py" ], "env": { "IOTDB_HOST": "127.0.0.1", "IOTDB_PORT": "6667", "IOTDB_USER": "root", "IOTDB_PASSWORD": "root", "IOTDB_DATABASE": "test", "IOTDB_SQL_DIALECT": "table" } } } }