IoTDB MCP 服务器

👁 铁匠徽章

概述

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

Related MCP server: Microsoft SQL Server MCP Server

成分

资源

服务器不公开任何资源。

提示

服务器没有提供任何提示。

工具

IoTDB 服务器提供了针对树形模型和表模型的不同工具。您可以通过将“IOTDB_SQL_DIALECT”配置设置为“tree”或“table”来选择。

树模型

• metadata_query

  • 执行 SHOW/COUNT 查询以从数据库读取元数据

  • 输入：

    • query_sql （字符串）：要执行的 SHOW/COUNT SQL 查询

  • 返回：查询结果作为对象数组

• select_query

  • 执行 SELECT 查询以从数据库读取数据

  • 输入：

    • query_sql (字符串): 要执行的 SELECT SQL 查询

  • 返回：查询结果作为对象数组

表格模型

查询工具

• read_query

  • 执行 SELECT 查询以从数据库读取数据

  • 输入：

    • query （字符串）：要执行的 SELECT SQL 查询

  • 返回：查询结果作为对象数组

架构工具

• list_tables

  • 获取数据库中所有表的列表

  • 无需输入

  • 返回：表名称数组

• describe-table

  • 查看特定表的架构信息

  • 输入：

    • table_name （字符串）：要描述的表的名称

  • 返回：具有名称和类型的列定义数组

Claude 桌面集成

先决条件

• 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

视窗

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

您可能需要在命令字段中输入 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",
 "IOTDB_SQL_DIALECT": "table"
 }
 }
 }
}

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• describe_tableC
• export_table_queryA
• list_tablesB
• read_queryB