「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
- Pythonをインストールし、
uvパッケージマネージャーを用意します。 - IoTDB MCPサーバーリポジトリをインストールまたはクローンします。
- Windsurfの設定ファイルを編集し、IoTDB MCPサーバーを追加します。
- 以下の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" } } } } - 設定を保存し、Windsurfを再起動します。
- サーバーが稼働し接続できているか確認してください。
Claude
- 事前にPython、
uv、IoTDBをインストールします。 - IoTDB MCPサーバーリポジトリをクローンします。
- MacOSでは
~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%/Claude/claude_desktop_config.jsonを編集します。 - 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" } } } } - 変更を保存し、Claude Desktopを再起動します。
- Claudeでサーバーが利用可能か確認してください。
Cursor
- Python、
uv、IoTDBをインストールします。 - MCPサーバーリポジトリをクローンします。
- Cursorの設定にMCPサーバーを追加します。
- 以下の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" } } } } - 設定を保存し、Cursorを再起動します。
- MCPサーバーがアクティブで応答するか確認してください。
Cline
- 必要な依存関係(Python、
uv、IoTDB)をインストールします。 - Apache IoTDB MCPサーバーをクローンします。
- Clineの設定ファイルを開きます。
- 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" } } } } - 保存してClineを再起動します。
- 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に置き換えてください。
概要
| セクション | 利用可否 | 詳細・備考 |
|---|---|---|
| 概要 | ✅ | |
| プロンプト一覧 | ⛔ | プロンプトは提供していません |
| リソース一覧 | ⛔ | リソースは公開していません |
| ツール一覧 | ✅ | 上記tree/tableツールを参照 |
| APIキーの安全な管理 | ✅ | 設定ファイルのenv利用 |
| サンプリング対応(評価上重要度低) | ⛔ | 記載なし |
評価
IoTDB MCPサーバーは、IoTDB向けに本質的なデータベース操作ツールに特化した、ミニマルでフォーカスされた実装です。プロンプトやリソース、roots、サンプリングといった高度なMCP機能はありませんが、時系列データベースアクセスという用途には非常に適しています。Claude Desktopのセットアップが詳細に記載されており、他の統合も標準的な手順で推察可能です。全体として、データベース中心ワークフローのためのニッチで堅実なMCPサーバーです。
MCPスコア
| ライセンスあり | ✅ (Apache-2.0) |
|---|---|
| 少なくとも1つのツール | ✅ |
| フォーク数 | 10 |
| スター数 | 24 |
