Apache IoTDB MCP Server

Čo robí “IoTDB” MCP Server?

Apache IoTDB MCP Server je implementácia Model Context Protocol (MCP), navrhnutá na umožnenie bezproblémovej interakcie s databázou a business intelligence cez IoTDB, časovo-radovú databázu. Ako most umožňuje AI asistentom a klientskym nástrojom vykonávať SQL dotazy voči IoTDB, čo podporuje analytiku dát a správu priamo cez prirodzený jazyk alebo programovateľné workflow poháňané LLM. Vývojári môžu pomocou MCP servera vykonávať databázové dotazy, zobrazovať informácie o schéme a získavať metadáta, čím zjednodušujú integráciu IoTDB do AI prostredí na úlohy ako dotazovanie časovo-radových dát a správa databázových schém.

Zoznam promptov

Server neposkytuje žiadne prompty.

Zoznam zdrojov

Server nesprístupňuje žiadne zdroje.

Zoznam nástrojov

IoTDB MCP Server ponúka rôzne nástroje podľa zvoleného SQL dialektu (“tree” alebo “table”).

Tree model

• metadata_query
  • Vykonáva SHOW/COUNT dotazy na získavanie metadát z IoTDB databázy.
  • Vstup: query_sql (string) – SQL dotaz SHOW/COUNT na vykonanie.
  • Výstup: Výsledky dotazu vo forme poľa objektov.
• select_query
  • Vykonáva SELECT dotazy na čítanie časovo-radových dát z databázy.
  • Vstup: query_sql (string) – SQL dotaz SELECT na vykonanie.
  • Výstup: Výsledky dotazu vo forme poľa objektov.

Table model

Nástroje pre dotazovanie

• read_query
  • Vykonáva SELECT dotazy na čítanie dát z databázy.
  • Vstup: query (string) – SQL dotaz SELECT na vykonanie.
  • Výstup: Výsledky dotazu vo forme poľa objektov.

Nástroje pre schému

• list_tables
  • Získava zoznam všetkých tabuliek v databáze.
  • Vstup: Žiadny.
  • Výstup: Pole názvov tabuliek.
• describe-table
  • Poskytuje informácie o schéme pre konkrétnu tabuľku.
  • Vstup: table_name (string) – Názov tabuľky na popis.
  • Výstup: Pole definícií stĺpcov s názvami a typmi.

Použitia tohto MCP servera

• Správa časovo-radovej databázy
  Jednoducho dotazujte, prehliadajte a spravujte rozsiahle časovo-radové dáta uložené v IoTDB priamo z AI asistentov alebo vývojárskych nástrojov poháňaných LLM.
• Prieskum schémy
  Získavajte a skúmajte schému databázy, získajte zoznamy tabuliek a popisy tabuliek na pochopenie a dokumentáciu štruktúry databázy.
• Integrácia Business Intelligence
  Integrujte dáta z IoTDB do BI workflow s prirodzeným jazykovým dotazovaním a analýzou schémy, čo uľahčuje analytiku a reporting.
• Automatizovaná dátová analytika
  Použite MCP server ako backend pre automatizované analytické pipeline, kde LLM generuje a vykonáva SQL dotazy podľa zámeru používateľa.
• Prehliadanie metadát
  Spúšťajte SHOW/COUNT dotazy na zobrazenie metadát databázy, čo pomáha pri monitorovaní, audite a optimalizácii databáz.

Ako ho nastaviť

Windsurf

1. Uistite sa, že máte nainštalovaný Python a správcu balíkov uv.
2. Nainštalujte alebo naklonujte repozitár IoTDB MCP Server.
3. Upravte konfiguračný súbor Windsurf a pridajte IoTDB MCP Server.
4. Použite nasledujúci JSON útržok v konfigurácii:

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

5. Uložte konfiguráciu a reštartujte Windsurf.
6. Overte, že server beží a je pripojený.

Claude

1. Nainštalujte Python, uv a IoTDB ako podmienky.
2. Naklonujte repozitár IoTDB MCP Server.
3. Na MacOS upravte ~/Library/Application Support/Claude/claude_desktop_config.json; na Windows upravte %APPDATA%/Claude/claude_desktop_config.json.
4. Pridajte položku MCP servera:

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

5. Uložte zmeny a reštartujte Claude Desktop.
6. Overte dostupnosť servera v Claude.

Cursor

1. Uistite sa, že máte nainštalovaný Python, uv a IoTDB.
2. Naklonujte repozitár MCP servera.
3. Upravte konfiguráciu Cursor a pridajte MCP server.
4. Použite nasledovný JSON:

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

5. Uložte konfiguráciu a reštartujte Cursor.
6. Uistite sa, že MCP server je aktívny a reaguje.

Cline

1. Nainštalujte potrebné závislosti: Python, uv a IoTDB.
2. Naklonujte Apache IoTDB MCP Server.
3. Otvorte konfiguračný súbor Cline.
4. Pridajte informácie o MCP serveri podľa vzoru:

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

5. Uložte a reštartujte Cline.
6. Overte integráciu MCP servera.

Zabezpečenie API kľúčov
API prihlasovacie údaje ako IOTDB_USER a IOTDB_PASSWORD sú spravované cez pole env v konfigurácii. Použite environmentálne premenné, aby ste sa vyhli pevnej zápisovanej hodnote citlivých údajov. Príklad:

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

A tieto environmentálne premenné nastavte vo vašom systéme pred spustením servera.

Ako používať tento MCP vo flow

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do vášho FlowHunt workflow začnite pridaním MCP komponentu do vášho flow a pripojením k AI agentovi:

Kliknite na MCP komponent, čím otvoríte panel konfigurácie. V časti systémovej konfigurácie MCP vložte detaily vášho MCP servera pomocou tohto JSON formátu:

{
  "iotdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po nakonfigurovaní bude AI agent schopný používať tento MCP server ako nástroj s prístupom ku všetkým jeho funkciám a možnostiam. Nezabudnite zmeniť “iotdb” na skutočný názov vášho MCP servera a nahradiť URL vašou vlastnou MCP server URL adresou.

Prehľad

Náš názor

IoTDB MCP Server je zameraná, minimalistická implementácia poskytujúca základné nástroje na interakciu s databázou IoTDB. Chýbajú jej pokročilé MCP funkcie ako prompty, zdroje, rooty či sampling, ale je výborne prispôsobená pre svoj špecifický prípad použitia v oblasti časovo-radových databáz. Nastavenie je dobre zdokumentované najmä pre Claude Desktop; ostatné integrácie sú odvodené, ale štandardné. Celkovo ide o špecializovaný, no spoľahlivý MCP server pre workflow zamerané na databázu.

MCP skóre