Iotdb MCP Server TreeModel

🚀 IoTDB MCP サーバのツリー構造モデル

このモデルは、IoTDB を通じて SQL クエリを実行し、データベースの相互作用とビジネスインテリジェンス機能を提供するモデルコンテキストプロトコル（MCP）サーバの実装です。

🚀 クイックスタート

このセクションでは、IoTDB MCP サーバの概要、コンポーネント、Claude デスクトップとの統合方法、開発手順について説明します。

✨ 主な機能

• データベースとの相互作用とビジネスインテリジェンス機能を提供します。
• IoTDB を通じて SQL クエリを実行できます。
• 3 つのコアツール（metadata_query、select_query）を提供します。

📦 インストール

前提条件

• uv パッケージマネージャ付きの Python
• IoTDB のインストール
• MCP サーバの依存関係

開発環境のセットアップ

# リポジトリをクローンする
git clone https://github.com/apache/iotdb-mcp-server.git
cd iotdb_mcp_server

# 仮想環境を作成する
uv venv
source venv/bin/activate  # または Windows の場合は `venv\Scripts\activate`

# 開発依存関係をインストールする
uv sync

💻 使用例

基本的な使用法

クエリツールの使用

# metadata_query の使用例
# メタデータを読み取るための SHOW/COUNT クエリを実行する
# 入力: query_sql (文字列): 実行する SHOW/COUNT SQL クエリ
# 戻り値: クエリ結果をオブジェクト配列として返す
# コード例は具体的な呼び出し方法が不明なため省略

# select_query の使用例
# データを読み取るための SELECT クエリを実行する
# 入力: query_sql (文字列): 実行する SELECT SQL クエリ
# 戻り値: クエリ結果をオブジェクト配列として返す
# コード例は具体的な呼び出し方法が不明なため省略

高度な使用法

Claude デスクトップとの統合

Claude デスクトップの設定ファイルで 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"
      }
    }
  }
}

🔧 技術詳細

コンポーネント

リソース

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

ヒント

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

ツール

このサーバは 3 つのコアツールを提供します。

クエリツール

• metadata_query
  • データベースからメタデータを読み取るための SHOW/COUNT クエリを実行します。
  • 入力:
    • query_sql (文字列): 実行する SHOW/COUNT SQL クエリ
  • 戻り値: クエリ結果をオブジェクト配列として返します。
• select_query
  • データベースからデータを読み取るための SELECT クエリを実行します。
  • 入力:
    • query_sql (文字列): 実行する SELECT SQL クエリ
  • 戻り値: クエリ結果をオブジェクト配列として返します。