IoTDB MCP-Server

👁 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 which uv unter MacOS/Linux oder where uv unter Windows ausführen.

{
 "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"
 }
 }
 }
}

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• describe_tableC
• export_table_queryA
• list_tablesB
• read_queryB