Apache IoTDB MCP Server

Hva gjør “IoTDB” MCP Server?

Apache IoTDB MCP Server er en implementering av Model Context Protocol (MCP) utformet for å gi sømløs databaseinteraksjon og business intelligence-funksjonalitet via IoTDB, en tidsseriedatabase. Ved å opptre som en bro muliggjør den for AI-assistenter og klienter å utføre SQL-spørringer mot IoTDB, og støtter dataanalyse og administrasjonsoppgaver direkte gjennom naturlig språk eller programmerbare LLM-drevne arbeidsflyter. Utviklere kan bruke MCP-serveren til å utføre databasespørringer, vise skjemainformasjon og hente metadata, noe som øker muligheten til å integrere IoTDB i AI-drevne utviklingsmiljø for oppgaver som spørring av tidsseriedata og håndtering av databaseskjemaer.

Liste over Prompter

Serveren tilbyr ingen prompter.

Liste over Ressurser

Serveren eksponerer ingen ressurser.

Liste over Verktøy

IoTDB MCP Server tilbyr ulike verktøy avhengig av valgt SQL-dialekt (“tree” eller “table”).

Tree-modell

• metadata_query
  • Utfører SHOW/COUNT-spørringer for å hente metadata fra IoTDB-databasen.
  • Input: query_sql (streng) – SHOW/COUNT SQL-spørringen som skal kjøres.
  • Output: Spørringsresultater som en liste med objekter.
• select_query
  • Utfører SELECT-spørringer for å lese tidsseriedata fra databasen.
  • Input: query_sql (streng) – SELECT SQL-spørringen som skal kjøres.
  • Output: Spørringsresultater som en liste med objekter.

Table-modell

Spørringsverktøy

• read_query
  • Utfører SELECT-spørringer for å lese data fra databasen.
  • Input: query (streng) – SELECT SQL-spørringen som skal kjøres.
  • Output: Spørringsresultater som en liste med objekter.

Skjemaverktøy

• list_tables
  • Henter en liste over alle tabeller i databasen.
  • Input: Ingen.
  • Output: Liste med tabellnavn.
• describe-table
  • Gir skjemainformasjon for en spesifikk tabell.
  • Input: table_name (streng) – Navnet på tabellen som skal beskrives.
  • Output: Liste med kolonndefinisjoner med navn og typer.

Bruksområder for denne MCP-serveren

• Tidsserie Databasehåndtering
  Spørr, bla gjennom og administrer store mengder tidsseriedata lagret i IoTDB direkte fra AI-assistenter eller LLM-drevne utviklerverktøy.
• Skjemautforskning
  Hent og utforsk databaseskjema, få tabellister og se tabellbeskrivelser for å forstå og dokumentere databasestrukturen.
• Business Intelligence-integrasjon
  Integrer IoTDB-data i BI-arbeidsflyter med naturlig språkspørring og skjema-analyse, noe som muliggjør analyse og rapportering.
• Automatisert dataanalyse
  Bruk MCP-serveren som backend for automatiserte dataanalyse-pipelines, der LLM-er genererer og kjører SQL-spørringer basert på brukerens hensikt.
• Metadata-inspeksjon
  Kjør SHOW/COUNT-spørringer for å vise databasemetadata, og hjelp til med overvåking, revisjon og databaseoptimalisering.

Hvordan sette det opp

Windsurf

1. Sørg for at du har Python installert og pakkebehandleren uv.
2. Installer eller klon IoTDB MCP Server-repositoriet.
3. Rediger Windsurf-konfigurasjonsfilen for å legge til IoTDB MCP Server.
4. Bruk følgende JSON-snutt i konfigurasjonen din:

   {
     "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. Lagre konfigurasjonen og start Windsurf på nytt.
6. Verifiser at serveren kjører og er tilkoblet.

Claude

1. Installer Python, uv og IoTDB som forutsetninger.
2. Klon IoTDB MCP Server-repositoriet.
3. På MacOS, rediger ~/Library/Application Support/Claude/claude_desktop_config.json; på Windows, rediger %APPDATA%/Claude/claude_desktop_config.json.
4. Legg til MCP-server-oppføring:

   {
     "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. Lagre endringene og start Claude Desktop på nytt.
6. Bekreft at serveren er tilgjengelig i Claude.

Cursor

1. Sørg for at Python, uv og IoTDB er installert.
2. Klon MCP-server-repositoriet.
3. Rediger Cursors konfigurasjon for å inkludere MCP-serveren.
4. Bruk følgende 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. Lagre konfigurasjonen og start Cursor på nytt.
6. Sørg for at MCP-serveren er aktiv og responsiv.

Cline

1. Installer nødvendige avhengigheter: Python, uv og IoTDB.
2. Klon Apache IoTDB MCP Server.
3. Åpne Clines konfigurasjonsfil.
4. Legg til MCP-serverinformasjonen som vist:

   {
     "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. Lagre og start Cline på nytt.
6. Sjekk MCP-server-integrasjonen.

Sikre API-nøkler
API-innloggingsdetaljer som IOTDB_USER og IOTDB_PASSWORD håndteres via env-feltet i konfigurasjonen. Bruk miljøvariabler for å unngå hardkoding av sensitiv informasjon. Eksempel:

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

Og sett disse miljøvariablene i systemet ditt før du starter serveren.

Hvordan bruke denne MCP-en i flyter

Bruk av MCP i FlowHunt

For å integrere MCP-servere i FlowHunt-arbeidsflyten din, start med å legge til MCP-komponenten i flyten og koble den til AI-agenten din:

Klikk på MCP-komponenten for å åpne konfigurasjonspanelet. I systemets MCP-konfigurasjonsseksjon limer du inn MCP-serverdetaljene dine med dette JSON-formatet:

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

Når dette er satt opp, kan AI-agenten bruke denne MCP-en som et verktøy med tilgang til alle funksjonene og mulighetene. Husk å endre “iotdb” til det faktiske navnet på MCP-serveren din og erstatte URL-en med din egen MCP-server-URL.

Oversikt

Vår vurdering

IoTDB MCP Server er en fokusert, minimal implementering som gir essensielle databaseverktøy for IoTDB. Den mangler avanserte MCP-funksjoner som prompter, ressurser, røtter og sampling, men passer godt til sin spesifikke bruk innen tidsseriedatabase-tilgang. Oppsettet er godt dokumentert for Claude Desktop; andre integrasjoner er antatt, men standard. Alt i alt er dette en nisje, men solid MCP-server for database-sentriske arbeidsflyter.

MCP Score