Cloudera Iceberg MCP Server (via Impala)

Cloudera Iceberg MCP サーバー（Impala 経由）

これは、Apache Impala 経由で Iceberg テーブルへの読み取り専用アクセスを提供する Model Context Protocol サーバーです。このサーバーを使用すると、LLM はデータベーススキーマを確認し、読み取り専用クエリを実行できます。

• execute_query(query: str): Impala で任意の SQL クエリを実行し、結果を JSON として返します。
• get_schema(): 現在のデータベースで利用可能なすべてのテーブルを一覧表示します。

Claude Desktop での使用方法

このサーバーを Claude Desktop アプリで使用するには、claude_desktop_config.json の「mcpServers」セクションに次の設定を追加します。

オプション 1：GitHub から直接インストール（推奨）

{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cloudera/iceberg-mcp-server@main",
        "run-server"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

オプション 2：ローカルにインストール（リポジトリをクローンした後）

{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/iceberg-mcp-server",
        "run",
        "src/iceberg_mcp_server/server.py"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

オプション 2 では、/path/to をこのリポジトリへのパスに置き換えてください。Impala の設定に合わせて環境変数を設定してください。

AI フレームワークでの使用方法

./examples フォルダーには、LangChain／LangGraph や OpenAI SDK など、一般的な AI フレームワークにこの MCP サーバーを統合する例がいくつか含まれています。

トランスポート

MCP サーバーのトランスポートプロトコルは、MCP_TRANSPORT 環境変数で設定できます。使用できる値は次のとおりです。

• stdio （デフォルト） — 標準入出力を介して通信します。ローカルツール、コマンドラインスクリプト、Claude Desktop などのクライアントとの統合に適しています。
• http - HTTP サーバーを公開します。ウェブベースのデプロイ、マイクロサービス、ネットワーク経由での MCP の公開に適しています。
• sse — Server-Sent Events（SSE）トランスポートを使用します。SSE に依存する既存のウェブベースのデプロイに適しています。

Copyright (c) 2025 - Cloudera, Inc. All rights reserved.