IoTDB MCP サーバー

概要

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

コンポーネント

リソース

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

プロンプト

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

ツール

サーバーは、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 (文字列): 記述するテーブルの名前
- 戻り値: 名前と型を持つ列定義の配列

クロードデスクトップ統合

前提条件

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

ウィンドウズ

場所: %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 MCP Server

Integrations