IoTDB MCP Server

Name: IoTDB MCP Server
Author: MCP-Mirror

@MCP-Mirror

Repository

About IoTDB MCP Server

Mirror of

#apache-iotdb #mcp-server #database-interaction

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is IoTDB MCP Server?

IoTDB MCP Server is an MCP server implementation that enables database interaction and business intelligence through IoTDB by running SQL queries. It is intended for use with AI assistants like Claude Desktop.

How to use IoTDB MCP Server?

Install the server with uv, configure the IoTDB connection via environment variables (host, port, user, password, database) in Claude Desktop's claude_desktop_config.json, and then invoke it through Claude Desktop's MCP client.

Key features of IoTDB MCP Server

Execute SELECT queries with read_query tool
List all tables in the database with list_tables tool
Describe table schema with describe-table tool
No resources or prompts exposed
Requires Python, uv, and IoTDB installation

Use cases of IoTDB MCP Server

Querying IoTDB time-series data through a chat interface
Exploring database schema without manual SQL clients
Automating business intelligence reports with natural language
Integrating IoTDB insights into AI-driven workflows

FAQ from IoTDB MCP Server

What tools does IoTDB MCP Server provide?

It provides three tools: read_query for reading data, list_tables to get all tables, and describe-table to view a table's schema.

How do I configure IoTDB MCP Server with Claude Desktop?

Add a server entry to Claude Desktop's claude_desktop_config.json with the uv command, path to server.py, and environment variables IOTDB_HOST, IOTDB_PORT, IOTDB_USER, IOTDB_PASSWORD, and IOTDB_DATABASE.

What are the prerequisites for using IoTDB MCP Server?

You need Python with the uv package manager, an IoTDB installation, and the MCP server dependencies installed via uv sync.

Does IoTDB MCP Server expose any resources or prompts?

No, the server does not expose any resources or prompts; it only provides the three described tools.

How are database credentials handled?

They are set in the environment variables IOTDB_USER and IOTDB_PASSWORD during server configuration.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K