关于 IoTDB MCP Server for Tree Model
IoTDB MCP Server for Tree Model 通过面向 SQL 的 MCP 工具查询 IoTDB 数据,并区分元数据查询与 SELECT 查询,结果以对象数组返回。
主要功能
- 01执行 SHOW 和 COUNT 元数据查询
- 02执行 SELECT 数据查询
- 03以对象数组返回查询结果
适用场景
- 01使用 SHOW 或 COUNT 语句检查 IoTDB 元数据
- 02使用 SELECT 语句读取数据库记录
MCP 相关
向 MCP 客户端提供 metadata_query 和 select_query 工具,不提供资源或提示词。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
面向树模型的 IoTDB MCP 服务
概述
一个模型上下文协议(MCP)服务实现,通过 IoTDB 提供数据库交互和商业智能能力。此服务支持运行 SQL 查询。
组件
资源
此服务不提供任何资源。
提示词
此服务不提供任何提示词。
工具
此服务提供三个核心工具:
查询工具
metadata_query- 执行 SHOW/COUNT 查询,从数据库读取元数据
- 输入:
query_sql(string):要执行的 SHOW/COUNT SQL 查询- 返回:由对象组成的数组形式的查询结果
select_query- 执行 SELECT 查询,从数据库读取数据
- 输入:
query_sql(string):要执行的 SELECT SQL 查询
- 返回:由对象组成的数组形式的查询结果
Claude Desktop 集成
先决条件
- Python 和
uv包管理器 - IoTDB 安装
- MCP 服务依赖项
开发
# Clone the repository
git clone https://github.com/apache/iotdb-mcp-server.git
cd iotdb_mcp_server
# Create virtual environment
uv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows
# Install development dependencies
uv sync
在 Claude Desktop 的配置文件中配置 MCP 服务:
MacOS
位置:~/Library/Application Support/Claude/claude_desktop_config.json
Windows
位置:%APPDATA%/Claude/claude_desktop_config.json
你可能需要在 command 字段中填写 uv 可执行文件的完整路径。在 MacOS/Linux 上运行 which uv,或在 Windows 上运行 where uv,即可获取该路径。
{
"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"
}
}
}
}
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。