
IoTDB MCP Server for Tree Model

2025.04.14
0
Python数据库交互商业智能数据库
IoTDB MCP Server for Tree Model 是一个基于IoTDB的模型上下文协议(MCP)服务器实现,提供数据库交互和商业智能能力。该服务器支持通过SQL查询与IoTDB数据库进行交互,适用于需要高效数据查询和分析的场景。
View on GitHub
Overview
基本能力
产品定位
IoTDB MCP Server for Tree Model 是一个专为IoTDB设计的MCP服务器,旨在通过SQL查询提供数据库交互和商业智能能力。
核心功能
- 提供两种核心查询工具:
metadata_query
:执行SHOW/COUNT查询,读取数据库元数据。select_query
:执行SELECT查询,读取数据库数据。
适用场景
- 数据库交互:通过SQL查询与IoTDB数据库进行交互。
- 商业智能:支持数据分析和商业智能应用。
工具列表
metadata_query
:执行SHOW/COUNT查询,返回查询结果作为对象数组。select_query
:执行SELECT查询,返回查询结果作为对象数组。
常见问题解答
- 无明确常见问题解答内容。
使用教程
使用依赖
- 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服务器:
- 在Claude Desktop的配置文件中配置MCP服务器,配置文件路径如下:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
- MacOS:
- 示例配置:
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" } } } }
- 确保IoTDB服务已启动并配置正确。