Iotdb MCP Server

🚀 IoTDB MCP サーバー

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

🚀 クイックスタート

このセクションでは、IoTDB MCP サーバーの基本的な使い方を説明します。

✨ 主な機能

• IoTDB を通じたデータベースのやり取りとビジネスインテリジェンス機能の提供
• SQL クエリの実行サポート

📦 インストール

前提条件

• 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

💻 使用例

Claude Desktop との統合

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",
        "IOTDB_SQL_DIALECT": "table"
      }
    }
  }
}

📚 ドキュメント

コンポーネント

リソース

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

ヒント

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

ツール

このサーバーは、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 (文字列): 説明するテーブルの名前
  • 戻り値: 名前と型を含む列定義の配列