MCP提交

Apache Iotdb MCP Server

IoTDB MCP服务器实现，提供通过IoTDB进行数据库交互和业务智能分析的能力，支持SQL查询操作。

数据库家庭自动化与物联网 #数据库查询 #表结构管理 #IoTDB集成 #SQL服务 .Python

2分

2025-04-29 02:29:51

概述

安装

内容详情

替代品

什么是IoTDB MCP Server？

IoTDB MCP Server 是一个基于IoTDB的模型上下文协议服务器，允许您通过SQL查询访问和管理数据库中的数据。它提供了强大的查询、表管理和模式定义工具。

如何使用IoTDB MCP Server？

使用IoTDB MCP Server非常简单，只需配置环境并运行服务器即可开始执行SQL查询。您可以列出所有表、描述表结构以及执行数据读取操作。

适用场景

IoTDB MCP Server适用于需要实时数据分析的企业用户，例如工业物联网（IIoT）、能源管理、智能制造等领域。

主要功能

执行SQL查询通过内置的`read_query`工具执行SELECT语句来获取数据。

列出所有表使用`list_tables`工具快速查看数据库中所有可用的表。

描述表结构利用`describe_table`工具查看特定表的列名及其数据类型。

优势与局限性

优势

支持多种SQL查询功能，易于上手。

高效处理大规模时间序列数据。

集成IoTDB的强大功能，适合复杂业务需求。

局限性

对低延迟实时响应的支持可能有限。

需要安装IoTDB依赖项，初始配置较为繁琐。

如何使用

安装IoTDB MCP Server克隆GitHub仓库并设置Python虚拟环境。

配置环境变量在Claude Desktop配置文件中指定IoTDB连接信息。

启动服务器运行命令启动IoTDB MCP Server。

使用案例

查询设备数据从设备表中筛选出特定时间段内的数据。

查看表结构检查设备表的列名及类型。

常见问题

如何安装IoTDB MCP Server？首先克隆GitHub仓库，然后创建Python虚拟环境并安装依赖项。

IoTDB MCP Server支持哪些操作系统？目前支持Windows、MacOS和Linux。

如果忘记配置Claude Desktop怎么办？可以在配置文件中手动添加IoTDB MCP Server的相关信息。

IoTDB MCP 服务器

概述

一个基于模型上下文协议（MCP）的服务器实现，通过IoTDB提供数据库交互和商业智能功能。此服务器支持运行SQL查询。

组件

资源

该服务器没有暴露任何资源。

提示

该服务器不提供任何提示。

工具

该服务器提供了三个核心工具：

查询工具

read_query
- 执行SELECT查询以从数据库中读取数据
- 输入:
  - query (字符串): 要执行的SELECT SQL查询
- 返回: 查询结果作为对象数组

架构工具

list_tables
- 获取数据库中的所有表列表
- 无需输入
- 返回: 表名数组
describe-table
- 查看特定表的架构信息
- 输入:
  - table_name (字符串): 要描述的表名称
- 返回: 包含列定义（名称和类型）的数组

Claude 桌面集成

先决条件

带有 uv 包管理器的 Python
IoTDB 安装
MCP 服务器依赖项

开发

# 克隆仓库
git clone https://github.com/apache/iotdb-mcp-server.git
cd iotdb_mcp_server

# 创建虚拟环境
uv venv
source venv/bin/activate  # 或 `venv\Scripts\activate` 在 Windows 上

# 安装开发依赖项
uv sync

在 Claude 桌面的配置文件中配置 MCP 服务器：

MacOS

位置: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

位置: %APPDATA%/Claude/claude_desktop_config.json

您可能需要将 uv 可执行文件的完整路径放在命令字段中。您可以通过运行 which uv 在 MacOS/Linux 上或 where uv 在 Windows 上获得此路径。

{
  "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"
      }
    }
  }
}