IoTDB MCP Server
2025.04.04
0
Python数据库交互业务智能数据库
IoTDB MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现，专为 IoTDB 数据库设计，提供数据库交互和业务智能能力。该服务器支持运行 SQL 查询，适用于需要高效数据查询和管理的场景。
View on GitHub
Overview
基本能力
产品定位
IoTDB MCP Server 是一个数据库交互和业务智能工具，通过 MCP 协议提供对 IoTDB 数据库的访问和操作能力。
核心功能
- 数据库查询：支持执行 SELECT 查询，从数据库中读取数据。
- 表管理：可以列出数据库中的所有表，并查看特定表的架构信息。
适用场景
- 数据查询：需要从 IoTDB 数据库中提取和分析数据的场景。
- 数据库管理：需要查看和管理数据库表结构的场景。
工具列表
- read_query：执行 SELECT 查询，返回查询结果。
- list_tables：列出数据库中的所有表。
- describe-table：查看特定表的架构信息。
常见问题解答
无
使用教程
使用依赖
- 安装 Python 和
uv包管理器。 - 安装 IoTDB。
- 安装 MCP 服务器依赖。
安装教程
# 克隆仓库
git clone https://github.com/apache/iotdb-mcp-server.git
cd iotdb_mcp_server
# 创建虚拟环境
uv venv
source venv/bin/activate # 或在 Windows 上使用 `venv\Scripts\activate`
# 安装开发依赖
uv sync
调试方式
配置 MCP 服务器在 Claude Desktop 的配置文件中：
MacOS
位置：~/Library/Application Support/Claude/claude_desktop_config.json
Windows
位置：%APPDATA%/Claude/claude_desktop_config.json
配置示例：
{
"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"
}
}
}
}