IoTDB MCP Server for Tree Model

Tree Model 用 IoTDB MCP サーバー

概要

IoTDB を通じてデータベースとのやり取りやビジネスインテリジェンス機能を提供する、Model Context Protocol（MCP）サーバーの実装です。このサーバーでは SQL クエリを実行できます。

コンポーネント

リソース

このサーバーはリソースを公開しません。

プロンプト

このサーバーはプロンプトを提供しません。

ツール

このサーバーは、次の 2 つの主要なツールを提供します。

クエリツール

• metadata_query
  • SHOW／COUNT クエリを実行して、データベースからメタデータを読み取ります
  • 入力：
  • query_sql（文字列）：実行する SHOW／COUNT SQL クエリ
  • 戻り値：オブジェクトの配列としてのクエリ結果
• select_query
  • SELECT クエリを実行して、データベースからデータを読み取ります
  • 入力：
    • query_sql（文字列）：実行する SELECT SQL クエリ
  • 戻り値：オブジェクトの配列としてのクエリ結果

Claude Desktop との連携

前提条件

• uv パッケージマネージャーを使用できる Python
• 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

Windows

場所：%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"
      }
    }
  }
}