IoTDB MCP Server
2025.04.17
11
Python数据库交互业务智能数据库
IoTDB MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现，专为 IoTDB 数据库设计，提供数据库交互和业务智能能力。该服务器支持运行 SQL 查询，适用于需要高效数据管理和查询的场景。
View on GitHub
Overview
基本能力
产品定位
IoTDB MCP Server 是一个专为 IoTDB 数据库设计的 MCP 服务实现，提供数据库交互和业务智能能力。
核心功能
- 数据库查询：支持执行 SELECT 查询，从数据库中读取数据。
- 表管理：可以列出数据库中的所有表，并查看特定表的模式信息。
适用场景
- 数据查询：需要从 IoTDB 数据库中读取数据的场景。
- 表结构管理：需要查看数据库表结构信息的场景。
工具列表
- read_query：执行 SELECT 查询，返回查询结果。
- 输入：
query（字符串）：要执行的 SELECT SQL 查询。 - 返回：查询结果的对象数组。
- list_tables：获取数据库中所有表的列表。
- 无需输入。
- 返回：表名的数组。
- describe-table：查看特定表的模式信息。
- 输入：
table_name（字符串）：要描述的表名。 - 返回：列定义的数组，包含列名和类型。
常见问题解答
- 如何配置 MCP 服务器？
- 需要在 Claude Desktop 的配置文件中配置 MCP 服务器，指定命令、参数和环境变量。
使用教程
使用依赖
- 安装 Python 和
uv包管理器。 - 安装 IoTDB。
- 安装 MCP 服务器依赖。
安装教程
- 克隆仓库：
bash git clone https://github.com/apache/iotdb-mcp-server.git cd iotdb_mcp_server - 创建虚拟环境：
bash uv venv source venv/bin/activate # 或在 Windows 上使用 `venv\Scripts\activate` - 安装开发依赖：
bash uv sync
调试方式
- 配置 MCP 服务器后，可以通过运行
server.py来启动服务器。 - 确保环境变量（如
IOTDB_HOST、IOTDB_PORT等）已正确设置。