Overview
Features
Dialect-based query model support
Supports running queries using either Tree Model or Table Model dialects by configuring IOTDB_SQL_DIALECT ('tree' or 'table'), enabling the appropriate tools and workflows.
Tree Model metadata and data queries
Tree Model tools include metadata_query and select_query to read metadata and data, returning results as arrays of objects.
Table Model data access and schema tools
Table Model tools include read_query, list_tables, and describe_table to query data, discover tables, and inspect schemas.
Export functionality for query results
Export results to CSV or Excel via export_query (Tree) and export_table_query (Table), with optional filename and a preview of data.
Performance optimization: Session pool management
Optimized session pool supporting up to 100 concurrent sessions to improve concurrency and throughput.
Performance optimization: Optimized fetch size
Configured fetch size of 1024 for queries to balance latency and data transfer.
Performance optimization: Connection retry
Automatic retry mechanism for handling transient connection failures.
Performance optimization: Timeout management
Session wait timeout set to 5000 milliseconds to improve reliability and responsiveness.
Who Is This For?
- Data Engineers / IoTDB Administrators:Set up and operate the MCP server to run TREE/TABLE queries against IoTDB, manage connections, and monitor performance.
- BI Developers / Analysts:Execute queries and export results to CSV/Excel for reporting and dashboarding workflows.
- Application Developers / Integrators:Integrate the MCP server with client applications and workflows, leveraging the two SQL dialects and export capabilities.
- Claude Desktop users:Configure and use the MCP server within Claude Desktop integrations for streamlined IoTDB interactions.




