Apache Iotdb MCP Server

🚀 IoTDB MCP サーバー

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

✨ 主な機能

• モデルコンテキストプロトコル（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

💻 使用例

クエリツール

# 以下は `read_query` ツールの使用例です
# このツールは SELECT クエリを実行してデータベースからデータを読み取ります
# 入力:
# - `query` (文字列): 実行する SELECT SQL クエリ
# 戻り値: クエリ結果をオブジェクト配列として返します
# 注意: ここでは具体的なコードの実行環境やライブラリのインポートなどは省略しています

# サンプルクエリ
query = "SELECT * FROM your_table"
result = read_query(query)
print(result)

アーキテクチャツール

list_tables の使用例

# このツールはデータベース内のすべてのテーブルのリストを取得します
# 入力: なし
# 戻り値: テーブル名の配列
tables = list_tables()
print(tables)

describe-table の使用例

# このツールは特定のテーブルのアーキテクチャ情報を表示します
# 入力:
# - `table_name` (文字列): 説明するテーブルの名前
# 戻り値: 列定義（名前と型）を含む配列
table_name = "your_table"
schema = describe-table(table_name)
print(schema)

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つの主要なツールを提供しています。

クエリツール

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

アーキテクチャツール

• list_tables
  • データベース内のすべてのテーブルのリストを取得します。
  • 入力: なし
  • 戻り値: テーブル名の配列
• describe-table
  • 特定のテーブルのアーキテクチャ情報を表示します。
  • 入力:
    • table_name (文字列): 説明するテーブルの名前
  • 戻り値: 列定義（名前と型）を含む配列