Iceberg MCP

IcebergMCP は、自然言語を使って Claude、Cursor、その他の MCP クライアントから Apache Iceberg™ のレイクハウスを操作できる Model Context Protocol（MCP）サーバーです。

目次

• インストール
  • 前提条件
  • Claude
  • Cursor
• 設定
• 利用可能なツール
• 使用例
• 制限事項とセキュリティ上の考慮事項
• 貢献

インストール

前提条件

• AWS Glue で管理されている Apache Iceberg™ カタログ
• カタログへのアクセス権を持つ AWS プロファイルがマシンに設定されていること
• uv パッケージマネージャー。brew install uv でインストールするか、公式インストールガイドを参照してください。

Claude

1. Claude で、Settings > Developer > Edit Config > claude_desktop_config.json に移動します

2. 以下を追加します：

{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "uv", // If uv can't be found, replace with full absolute path to uv
      "args": [
        "run",
        "--with",
        "iceberg-mcp",
        "iceberg-mcp"
      ],
      "env": {
        "ICEBERG_MCP_PROFILE": "<aws-profile-name>"
      }
    }
  }
}

Cursor

1. Cursor で、Settings -> Cursor Settings -> MCP -> Add new global MCP server に移動します

2. 以下を追加します：

{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "uv", // If uv can't be found, replace with full absolute path to uv
      "args": [
        "run",
        "--with",
        "iceberg-mcp",
        "iceberg-mcp"
      ],
      "env": {
        "ICEBERG_MCP_PROFILE": "<aws-profile-name>"
      }
    }
  }
}

設定

AWS 接続の設定には環境変数を使用できます。

• ICEBERG_MCP_PROFILE - 使用する AWS プロファイル名です。このロールが引き受けられ、カタログおよびオブジェクトストレージへの接続に使用されます。指定しない場合は、デフォルトのロールが使用されます。
• ICEBERG_MCP_REGION - 使用する AWS リージョンです。カタログとオブジェクトストレージの場所を特定するために使用されます。デフォルトは us-east-1 です。

利用可能なツール

このサーバーは、Apache Iceberg™ テーブルを操作するために次のツールを提供します。

• get_namespaces：Apache Iceberg™ カタログ内のすべてのネームスペースを取得します
• get_iceberg_tables：指定したネームスペース内のすべてのテーブルを取得します
• get_table_schema：指定したテーブルのスキーマを返します
• get_table_properties：指定したテーブルの合計サイズやレコード数などのプロパティを返します
• get_table_partitions：指定したテーブルのすべてのパーティションを取得します

使用例

インストールと設定が完了したら、MCP クライアントを通じて Apache Iceberg™ テーブルを操作できます。レイクハウスとのやり取りの簡単な例を以下に示します。

1. 「カタログ内のすべてのネームスペースを一覧表示して」
2. 「bronze という名前のネームスペース内のテーブルをすべて一覧表示して」
3. 「テーブル raw_events にある文字列型の列をすべて教えて」
4. 「raw_events テーブルのサイズはどのくらい？」
5. 「users_info のすべての VIP ユーザーについて、raw_metrics のすべての数値列の合計と p95 を計算する SQL クエリを生成して」
6. 「最近、raw_events に対するクエリが大幅に遅くなったのはなぜ？」

制限事項とセキュリティ上の考慮事項

• 現在、すべてのツールは読み取り専用であり、レイクハウスのデータを変更または削除することはできません
• 現在サポートされているカタログ：
  • AWS Glue
  • Apache Iceberg™ REST Catalog（近日対応予定！）

貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。