IoTDB MCP-Server

Ü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.

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Ein Server, der das Ausführen von SQL-Abfragen für IoTDB-Datenbanken ermöglicht und Datenlesefunktionen und Schemainformationen über eine Model Context Protocol-Schnittstelle bereitstellt.

Related MCP Servers

MySQL-MCP
zajTools
-
security
F
license
-
quality
A Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.
Last updated -
JavaScript
Microsoft SQL Server MCP Server
RichardHan
A
security
A
license
A
quality
A Model Context Protocol server that enables secure interaction with Microsoft SQL Server databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Last updated -
1
153
Python
MIT License
MSSQL MCP Server
knight0zh
-
security
A
license
-
quality
A Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.
Last updated -
3
TypeScript
MIT License
IoTDB MCP Server
JackieTien97
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to securely interact with Apache IoTDB databases through a controlled interface for listing tables, reading data, and executing SQL queries.
Last updated -
Python

View all related MCP servers

IoTDB MCP Server