Apache IoTDB MCP 服务器

“IoTDB” MCP 服务器是做什么的？

Apache IoTDB MCP 服务器 是模型上下文协议（MCP）的一个实现，旨在通过 IoTDB 时序数据库，为数据库交互与商业智能能力提供无缝支持。它作为桥梁，使 AI 助手和客户端能够对 IoTDB 执行 SQL 查询，支持通过自然语言或编程方式在大模型驱动的工作流中进行数据分析和管理任务。开发者可以借助 MCP 服务器执行数据库查询、查看模式信息和获取元数据，提升将 IoTDB 集成到 AI 驱动开发环境中的能力，例如查询时序数据、管理数据库结构等。

提示词清单

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

资源清单

该服务器不暴露任何资源。

工具清单

IoTDB MCP 服务器根据所选 SQL 方言（“tree” 或 “table”）提供不同工具。

树形模型

• metadata_query
  • 执行 SHOW/COUNT 查询以获取 IoTDB 数据库的元数据。
  • 输入：query_sql（字符串）– 需要执行的 SHOW/COUNT SQL 查询。
  • 输出：查询结果为对象数组。
• select_query
  • 执行 SELECT 查询，从数据库读取时序数据。
  • 输入：query_sql（字符串）– 需要执行的 SELECT SQL 查询。
  • 输出：查询结果为对象数组。

表格模型

查询工具

• read_query
  • 执行 SELECT 查询，从数据库读取数据。
  • 输入：query（字符串）– 需要执行的 SELECT SQL 查询。
  • 输出：查询结果为对象数组。

模式工具

• list_tables
  • 获取数据库中所有表的列表。
  • 输入：无。
  • 输出：表名数组。
• describe-table
  • 提供指定表的模式信息。
  • 输入：table_name（字符串）– 需要描述的表名。
  • 输出：包含列名和类型的列定义数组。

本 MCP 服务器的典型应用场景

• 时序数据库管理
  可通过 AI 助手或大模型开发工具直接查询、浏览和管理存储在 IoTDB 中的大规模时序数据。
• 模式探索
  获取和探索数据库结构，列出所有表并查看表结构描述，便于理解和文档化数据库架构。
• 商业智能集成
  将 IoTDB 数据集成到 BI 工作流中，支持自然语言查询和模式分析，方便分析和报表。
• 自动化数据分析
  可作为自动化数据分析流水线的后端，让大模型根据用户意图生成并执行 SQL 查询。
• 元数据检查
  通过 SHOW/COUNT 查询查看数据库元数据，有助于监控、审计和数据库优化。

如何设置

Windsurf

1. 确保已安装 Python 和 uv 包管理器。
2. 安装或克隆 IoTDB MCP 服务器仓库。
3. 编辑 Windsurf 配置文件，添加 IoTDB MCP 服务器。
4. 在配置中使用如下 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_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. 保存配置并重启 Windsurf。
6. 验证服务器是否已运行并连接。

Claude

1. 安装 Python、uv 和 IoTDB。
2. 克隆 IoTDB MCP 服务器仓库。
3. 在 MacOS 下，编辑 ~/Library/Application Support/Claude/claude_desktop_config.json；在 Windows 下，编辑 %APPDATA%/Claude/claude_desktop_config.json。
4. 添加 MCP 服务器配置项：

   {
     "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_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. 保存更改并重启 Claude Desktop。
6. 在 Claude 中确认服务器是否可用。

Cursor

1. 确保已安装 Python、uv 和 IoTDB。
2. 克隆 MCP 服务器仓库。
3. 编辑 Cursor 的配置文件，包含 MCP 服务器配置项。
4. 使用如下 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_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. 保存配置并重启 Cursor。
6. 确认 MCP 服务器已激活并正常响应。

Cline

1. 安装所需依赖：Python、uv 和 IoTDB。
2. 克隆 Apache IoTDB MCP 服务器。
3. 打开 Cline 的配置文件。
4. 添加 MCP 服务器信息，如下所示：

   {
     "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_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. 保存并重启 Cline。
6. 检查 MCP 服务器集成情况。

API 密钥安全
如 IOTDB_USER 和 IOTDB_PASSWORD 等 API 凭证通过配置中的 env 字段进行管理。建议使用环境变量，避免硬编码敏感数据。例如：

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

并在启动服务器前，在系统中设置这些环境变量。

如何在流程中使用 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成进您的 FlowHunt 工作流，首先添加 MCP 组件到流程中并连接到 AI Agent：

点击 MCP 组件打开配置面板。在系统 MCP 配置区域，按如下 JSON 格式填写您的 MCP 服务器信息：

{
  "iotdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI Agent 即可作为工具使用该 MCP，并访问其全部功能。请注意将 “iotdb” 改为实际的 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

总览

我们的观点

IoTDB MCP 服务器是一个专注且简洁的实现，为 IoTDB 提供了核心的数据库交互工具。虽然缺乏如提示词、资源、根节点和采样等高级 MCP 功能，但非常适合时序数据库访问这一特定场景。Claude Desktop 的配置文档详尽，其他集成也可依此类推。总体而言，这是一款针对数据库工作流的小众但可靠的 MCP 服务器。

MCP 评分