IoTDB MCP Server for Tree Model

IoTDB MCP Server for Tree Model

site icon
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 服务器依赖。

安装教程

  1. 克隆仓库: bash git clone https://github.com/apache/iotdb-mcp-server.git cd iotdb_mcp_server
  2. 创建虚拟环境: bash uv venv source venv/bin/activate # 或在Windows上使用 `venv\Scripts\activate`
  3. 安装开发依赖: bash uv sync

调试方式

  1. 配置MCP服务器:
  2. 在Claude Desktop的配置文件中配置MCP服务器,配置文件路径如下:
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
  3. 示例配置: 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" } } } }
  4. 确保IoTDB服务已启动并配置正确。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。