Apache IoTDB MCPサーバー

「IoTDB」MCPサーバーは何をするのか？

Apache IoTDB MCPサーバーは、Model Context Protocol (MCP) の実装であり、IoTDB（時系列データベース）を通じたシームレスなデータベース操作やビジネスインテリジェンス機能を提供します。AIアシスタントやクライアントがIoTDBに対してSQLクエリを実行できるように橋渡しをし、自然言語またはプログラムによるLLMワークフローでデータ分析や管理作業を直接サポートします。開発者はMCPサーバーを通じてデータベースクエリ、スキーマ情報の閲覧、メタデータ取得などが可能となり、時系列データのクエリやスキーマ管理など、AI活用の開発環境にIoTDBを統合できます。

プロンプト一覧

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

リソース一覧

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

ツール一覧

IoTDB MCPサーバーは、選択したSQL方言（“tree” または “table”）によって異なるツールを提供します。

Treeモデル

• metadata_query
  • IoTDBデータベースからメタデータを取得するSHOW/COUNTクエリを実行します。
  • 入力: query_sql (文字列) – 実行するSHOW/COUNT SQLクエリ
  • 出力: オブジェクト配列としてクエリ結果
• select_query
  • データベースから時系列データを読み込むSELECTクエリを実行します。
  • 入力: query_sql (文字列) – 実行するSELECT SQLクエリ
  • 出力: オブジェクト配列としてクエリ結果

Tableモデル

クエリツール

• read_query
  • データベースからデータを読むSELECTクエリを実行します。
  • 入力: query (文字列) – 実行するSELECT SQLクエリ
  • 出力: オブジェクト配列としてクエリ結果

スキーマツール

• list_tables
  • データベース内の全テーブル一覧を取得します。
  • 入力: なし
  • 出力: テーブル名の配列
• describe-table
  • 指定したテーブルのスキーマ情報を提供します。
  • 入力: table_name (文字列) – 説明するテーブル名
  • 出力: カラム名と型を含むカラム定義の配列

このMCPサーバーのユースケース

• 時系列データベース管理
  AIアシスタントやLLM搭載開発ツールから直接、大規模な時系列データのクエリ・閲覧・管理が容易に行えます。
• スキーマ探索
  データベーススキーマの取得・探索、テーブル一覧や詳細の確認で構造把握やドキュメント化を支援。
• ビジネスインテリジェンス統合
  自然言語クエリやスキーマ解析により、IoTDBデータをBIワークフローへ統合し、分析やレポート作成を促進。
• 自動データ分析
  LLMがユーザー意図に応じてSQLクエリを生成・実行できる自動分析パイプラインのバックエンドとして利用可能。
• メタデータ検査
  SHOW/COUNTクエリでデータベースのメタデータを取得し、監視・監査・最適化作業を支援。

セットアップ方法

Windsurf

1. Pythonをインストールし、uvパッケージマネージャーを用意します。
2. IoTDB MCPサーバーリポジトリをインストールまたはクローンします。
3. Windsurfの設定ファイルを編集し、IoTDB MCPサーバーを追加します。
4. 以下のJSONスニペットを設定に使用します:

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

5. 設定を保存し、Windsurfを再起動します。
6. サーバーが稼働し接続できているか確認してください。

Claude

1. 事前にPython、uv、IoTDBをインストールします。
2. IoTDB MCPサーバーリポジトリをクローンします。
3. MacOSでは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%/Claude/claude_desktop_config.jsonを編集します。
4. MCPサーバーのエントリを追加します:

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

5. 変更を保存し、Claude Desktopを再起動します。
6. Claudeでサーバーが利用可能か確認してください。

Cursor

1. Python、uv、IoTDBをインストールします。
2. MCPサーバーリポジトリをクローンします。
3. Cursorの設定にMCPサーバーを追加します。
4. 以下のJSONを使用します:

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

5. 設定を保存し、Cursorを再起動します。
6. MCPサーバーがアクティブで応答するか確認してください。

Cline

1. 必要な依存関係（Python、uv、IoTDB）をインストールします。
2. Apache IoTDB MCPサーバーをクローンします。
3. Clineの設定ファイルを開きます。
4. MCPサーバー情報を以下のように追加します:

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

5. 保存してClineを再起動します。
6. MCPサーバー統合を確認してください。

APIキーの安全な管理
IOTDB_USERやIOTDB_PASSWORDなどのAPI認証情報は、設定のenvフィールドで管理します。機密データのハードコーディングを避けるため、環境変数を使いましょう。例:

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

サーバー起動前に、これらの環境変数をシステム上で設定してください。

フロー内でのMCP利用方法

FlowHuntでのMCP利用

FlowHuntワークフローにMCPサーバーを統合するには、まずMCPコンポーネントをフローに追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開き、システムMCP設定欄に次のJSON形式でMCPサーバー情報を入力します:

{
  "iotdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AIエージェントがこのMCPをツールとして利用し、すべての機能や能力にアクセスできるようになります。“iotdb"は実際のMCPサーバー名に、URLはご自身のMCPサーバーURLに置き換えてください。

概要

評価

IoTDB MCPサーバーは、IoTDB向けに本質的なデータベース操作ツールに特化した、ミニマルでフォーカスされた実装です。プロンプトやリソース、roots、サンプリングといった高度なMCP機能はありませんが、時系列データベースアクセスという用途には非常に適しています。Claude Desktopのセットアップが詳細に記載されており、他の統合も標準的な手順で推察可能です。全体として、データベース中心ワークフローのためのニッチで堅実なMCPサーバーです。

MCPスコア