IoTDB模型上下文协议服务器

IoTDB模型上下文协议服务器(iotdb-mcp-server)是为Apache IoTDB设计的MCP服务器实现。该服务器为AI助手提供了一种安全、结构化的方式来探索和分析数据库,支持列出表、读取数据以及通过受控接口执行SQL查询,确保数据库访问的安全性和责任性。

  • by JackieTien97
  • 更新于
在 GitHub 查看 JackieTien97/iotdb_mcp_server

使用说明

基本能力

产品定位

IoTDB模型上下文协议服务器为AI助手提供安全、结构化的数据库访问接口,支持对IoTDB数据库的探索和分析。

核心功能

  • list_resources:列出数据库中的表
  • read_resource:读取表数据
  • list_tools:列出可用工具
  • call_tool:执行SQL查询
  • list_prompts:列出提示
  • get_prompt:按名称获取提示

适用场景

  • AI助手与IoTDB数据库的集成
  • 安全、受控的数据库访问
  • 数据库探索和分析

使用教程

使用依赖

  • Python及uv包管理器
  • IoTDB安装
  • MCP服务器依赖

安装教程

# 克隆仓库
git clone https://github.com/JackieTien97/iotdb_mcp_server.git
cd iotdb_mcp_server

# 创建虚拟环境
uv venv
source venv/bin/activate  # Windows系统使用`venvScriptsactivate`

# 安装开发依赖
uv sync

调试方式

配置Claude Desktop的配置文件以集成MCP服务器:

MacOS

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

Windows

配置文件位置:%APPDATA%/Claude/claude_desktop_config.json

配置示例:

{
  "mcpServers": {
    "iotdb": {
      "command": "~/PycharmProjects/iotdb_mcp_server/.venv/bin/python",
      "args": [
        "~/PycharmProjects/iotdb_mcp_server/src/iotdb_mcp_server/server.py"
      ],
      "env": {
        "IOTDB_HOST": "127.0.0.1",
        "IOTDB_PORT": "6667",
        "IOTDB_USER": "root",
        "IOTDB_PASSWORD": "root",
        "IOTDB_DATABASE": "test"
      }
    }
  }
}