iotdb-mcp-server

一个用于 IoTDB 的模型上下文协议 (MCP) 服务器实现。

该服务器为 AI 助手提供了一种安全且结构化的方式来探索和分析数据库。它使它们能够通过受控接口列出表、读取数据和执行 SQL 查询，确保负责任的数据库访问。

功能

• list_resources 列出表
• read_resource 读取表数据
• list_tools 列出工具
• call_tool 执行 SQL
• list_prompts 列出提示
• get_prompt 按名称获取提示

使用

前提条件

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

开发

# Clone the repository
git clone https://github.com/JackieTien97/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 集成

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