Skip to main content
Glama
IoTDB MCP Server

IoTDB MCP Server

Official
by apache

IoTDB MCP 서버

대장간 배지

개요

IoTDB를 통해 데이터베이스 상호작용 및 비즈니스 인텔리전스 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 SQL 쿼리를 실행할 수 있습니다.

Related MCP server: XiYan MCP Server

구성 요소

자원

서버는 어떤 리소스도 노출하지 않습니다.

프롬프트

서버는 어떠한 프롬프트도 제공하지 않습니다.

도구

이 서버는 IoTDB 트리 모델과 테이블 모델에 대한 다양한 도구를 제공합니다. "IOTDB_SQL_DIALECT" 구성을 "트리" 또는 "테이블"로 설정하여 원하는 도구를 선택할 수 있습니다.

트리 모델

  • metadata_query

    • 데이터베이스에서 메타데이터를 읽으려면 SHOW/COUNT 쿼리를 실행하세요.

    • 입력:

      • query_sql (문자열): 실행할 SHOW/COUNT SQL 쿼리

    • 반환: 객체 배열로 쿼리 결과

  • select_query

    • 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.

    • 입력:

      • query_sql (문자열): 실행할 SELECT SQL 쿼리

    • 반환: 객체 배열로 쿼리 결과

테이블 모델

쿼리 도구
  • read_query

    • 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.

    • 입력:

      • query (문자열): 실행할 SELECT SQL 쿼리

    • 반환: 객체 배열로 쿼리 결과

스키마 도구
  • list_tables

    • 데이터베이스의 모든 테이블 목록을 가져옵니다.

    • 입력이 필요하지 않습니다

    • 반환: 테이블 이름 배열

  • describe-table

    • 특정 테이블에 대한 스키마 정보 보기

    • 입력:

      • table_name (문자열): 설명할 테이블의 이름

    • 반환: 이름과 유형이 포함된 열 정의 배열

Claude 데스크톱 통합

필수 조건

  • uv 패키지 관리자를 사용한 Python

  • IoTDB 설치

  • MCP 서버 종속성

개발

지엑스피1

Claude Desktop의 구성 파일에서 MCP 서버를 구성합니다.

맥OS

위치: ~/Library/Application Support/Claude/claude_desktop_config.json

윈도우

위치: %APPDATA%/Claude/claude_desktop_config.json

명령 필드에 uv 실행 파일의 전체 경로를 입력해야 할 수도 있습니다. MacOS/Linux에서는 which uv , Windows에서는 where uv 실행하여 경로를 확인할 수 있습니다.

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

Available Tools

4 tools
describe_tableC

Get the schema information for a specific table Args: table_name: name of the table to describe

Inputs: table_name (required).

export_table_queryA

Execute a query and export the results to a CSV or Excel file.

Args: query_sql: The SQL query to execute (using TABLE dialect, time using ISO 8601 format, e.g. 2017-11-01T00:08:00.000) format: Export format, either "csv" or "excel" (default: "csv") filename: Optional filename for the exported file. If not provided, a unique filename will be generated.

SQL Syntax: SELECT ⟨select_list⟩ FROM ⟨tables⟩ [WHERE ⟨condition⟩] [GROUP BY ⟨groups⟩] [HAVING ⟨group_filter⟩] [FILL ⟨fill_methods⟩] [ORDER BY ⟨order_expression⟩] [OFFSET ⟨n⟩] [LIMIT ⟨n⟩];

Returns: Information about the exported file and a preview of the data (max 10 rows)

Inputs: query_sql (required), format, filename.

list_tablesB

List all tables in the IoTDB database.

Inputs: no named parameters.

read_queryB

Execute a SELECT query on the IoTDB. Please use table sql_dialect when generating SQL queries.

Args: query_sql: The SQL query to execute (using TABLE dialect, time using ISO 8601 format, e.g. 2017-11-01T00:08:00.000)

Inputs: query_sql (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 4 tools

    Disambiguation3/5

    The tools have distinct primary functions (describe, export, list, read), but there's significant overlap between export_table_query and read_query as both execute SQL queries. The descriptions clarify that export_table_query focuses on file export while read_query returns query results directly, but an agent might still confuse when to use each for data retrieval.

    Naming Consistency4/5

    Three tools follow a consistent verb_noun pattern (describe_table, list_tables, export_table_query), while read_query deviates slightly by using 'read' instead of a more specific verb like 'execute' or 'run'. The naming is mostly predictable and readable, with only minor inconsistency in the verb choice for one tool.

    Tool Count4/5

    Four tools is a reasonable count for a database server, allowing core operations without being overwhelming. However, it feels slightly thin for full IoTDB coverage, as it lacks tools for table creation, deletion, or data insertion, which might be expected in a complete database interface.

    Completeness2/5

    The toolset is severely incomplete for a database server. It covers read operations (list, describe, query) and export, but lacks any write capabilities (create, insert, update, delete) or administrative functions. This creates significant gaps that will cause agent failures when trying to perform basic database management tasks.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.
      1,462 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables natural language queries to MySQL databases, powered by XiYanSQL text-to-SQL technology.
      239
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.
      1
      6
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that allows executing SELECT queries on TiDB databases, with optional support for INSERT, UPDATE, and DELETE operations when explicitly enabled.
      1
      8 npm
      -