iotdb-mcp-server logo

iotdb-mcp-server

by JackieTien97

The iotdb-mcp-server is a Model Context Protocol (MCP) server implementation for IoTDB. It provides AI assistants with a secure and structured way to explore and analyze IoTDB databases through a controlled interface.

View on GitHub

Last updated: N/A

What is iotdb-mcp-server?

This server is a Model Context Protocol (MCP) server designed to interface with IoTDB. It allows AI assistants to interact with and analyze data stored in IoTDB in a secure and structured manner.

How to use iotdb-mcp-server?

To use the server, you need Python with the uv package manager, an IoTDB installation, and the server's dependencies. Clone the repository, create a virtual environment, install dependencies, and configure the MCP server in Claude Desktop's configuration file with the correct paths and environment variables for your IoTDB instance.

Key features of iotdb-mcp-server

  • list_resources (list tables)

  • read_resource (read table data)

  • list_tools (list tools)

  • call_tool (execute an SQL)

  • list_prompts (list prompts)

  • get_prompt (get the prompt by name)

Use cases of iotdb-mcp-server

  • Enabling AI assistants to explore IoTDB databases

  • Allowing AI to analyze IoT data

  • Providing a secure interface for AI to query IoTDB

  • Integrating IoTDB with AI-powered applications

FAQ from iotdb-mcp-server

What is MCP?

MCP stands for Model Context Protocol, a protocol for AI assistants to interact with data sources.

What is IoTDB?

IoTDB is a database system designed for IoT data management.

How do I install the dependencies?

Use uv sync after activating the virtual environment.

Where do I configure the server for Claude Desktop?

The configuration file is located at ~/Library/Application Support/Claude/claude_desktop_config.json on MacOS and %APPDATA%/Claude/claude_desktop_config.json on Windows.

What environment variables are required?

The required environment variables are IOTDB_HOST, IOTDB_PORT, IOTDB_USER, IOTDB_PASSWORD, and IOTDB_DATABASE.