Iceberg MCP

Iceberg MCP

非同期処理とロギングに対応した、Apache Iceberg カタログ向けの MCP サーバーです。

Iceberg MCP デモ

対応カタログ

カタログの種類	対応
Rest カタログ	✅
AWS Glue	✅
Hive Metastore	❌
S3 Table	❌

対応ツール

ツール	説明
namespaces	Iceberg カタログ内のすべてのネームスペースを取得します
tables	指定したネームスペース内のすべてのテーブルを取得します
table_schema	指定したテーブルのスキーマを返します
table_properties	指定したテーブルのプロパティを返します

インストール

オプション 1：リリースバイナリをダウンロード

最新のビルド済みバイナリをリリースページからダウンロードします。

オプション 2：ソースからビルド

プロジェクトを手動でビルドするには、Rust がインストールされていることを確認してから、次を実行します。

cargo build --release

コンパイルされたバイナリは ./target/release/iceberg-mcp にあります。

クライアントの設定

Claude Desktop

Iceberg MCP を Claude Desktop と連携するには：

1. Settings > Developer > Edit Config を開きます。
2. claude_desktop_config.json を適切な設定で更新します。

• Rest カタログ

{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "rest",
        "REST_URI": "http://localhost:8080",
        "LOG_LEVEL": "info"
      }
    }
  }
}

• AWS Glue カタログ

// use PROFILE_NAME
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "glue",
        "AWS_CONFIG_FILE": "/Users/{your_username}/.aws/config",
        "AWS_SHARED_CREDENTIALS_FILE": "/Users/{your_username}/.aws/credentials",
        "PROFILE_NAME": "default",
        "GLUE_WAREHOUSE": "s3://{bucket_name}",
        "GLUE_ENDPOINT": "http://localhost:9000", // Glue service endpoint, optional
        "LOG_LEVEL": "info"
      }
    }
  }
}

// or use ACCESS_KEY and SECRET_KEY
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "glue",
        "GLUE_WAREHOUSE": "s3a://{bucket_name}",
        "GLUE_ENDPOINT": "http://localhost:9000", // Optional
        "AWS_ACCESS_KEY_ID": "my_access_id",
        "AWS_SECRET_ACCESS_KEY": "my_secret_key",
        "AWS_REGION_NAME": "us-east-1",
        "S3_ENDPOINT": "http://localhost:9000",
        "S3_ACCESS_KEY_ID": "admin",
        "S3_SECRET_ACCESS_KEY": "password",
        "S3_REGION": "us-east-1",
        "LOG_LEVEL": "info"
      }
    }
  }
}

デバッグ

Claude Desktop

トラブルシューティング用のログを表示するには、次を実行します。

tail -n 20 -F ~/Library/Logs/Claude/mcp-server-iceberg-mcp.log