Iceberg MCP

🚀 IcebergMCP

IcebergMCPは、モデルコンテキストプロトコル (MCP) サーバーです。これを使用すると、自然言語でApache Iceberg™ベースのLakehouseと対話でき、Claude、Cursor、またはその他のMCPクライアントをサポートします。

🚀 クイックスタート

IcebergMCPを使用することで、自然言語を通じてApache Iceberg™ベースのLakehouseとの対話が可能になります。以下に、インストール方法や使用例を紹介します。

📦 インストール

先决条件

• AWS Glueによって管理されるApache Iceberg™カタログ
• AWS資格情報ファイルが設定され、カタログにアクセスする権限があること
• uv パッケージマネージャーがインストールされていること - brew install uv を使用するか、公式インストールガイド を参照してください

Claude

1. Claudeで、設定 > 開発者 > 設定の編集 > claude_desktop_config.json に移動します。
2. 以下の内容を追加します。

{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "uv", // uvが見つからない場合は、絶対パスで置き換えてください。例: /path/to/uv
      "args": [
        "run",
        "--with",
        "iceberg-mcp",
        "iceberg-mcp"
      ],
      "env": {
        "ICEBERG_MCP_PROFILE": "<aws-profile-name>"
      }
    }
  }
}

Cursor

1. Cursorで、設定 -> Cursor設定 -> MCP -> 新しいグローバルMCPサーバーを追加 と進みます。
2. 以下の内容を追加します。

{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "uv", // uvが見つからない場合は、絶対パスで置き換えてください。例: /path/to/uv
      "args": [
        "run",
        "--with",
        "iceberg-mcp",
        "iceberg-mcp"
      ],
      "env": {
        "ICEBERG_MCP_PROFILE": "<aws-profile-name>"
      }
    }
  }
}

🔧 技術詳細

配置

環境変数を使用してAWS接続を構成します。

• ICEBERG_MCP_PROFILE - 使用するAWSプロファイル名。このロールは仮定され、カタログとオブジェクトストレージへの接続に使用されます。デフォルトではデフォルトロールが使用されます。
• ICEBERG_MCP_CATALOG - サポートされるカタログタイプ：
  • aws.glue
  • iceberg.rest（近日公開予定！）

利用可能なツール

現在のバージョンでは、以下のカタログがサポートされています。

AWS Glue

from iceberg_mcp.client import IcebergMCPClient

client = IcebergMCPClient(profile_name="your-aws-profile", catalog_type="aws.glue")
# またはリージョンを指定する場合
client = IcebergMCPClient(profile_name="your-aws-profile", region_name="us-west-2", catalog_type="aws.glue")

Apache Iceberg REST Catalog（近日公開予定）

from iceberg_mcp.client import IcebergMCPClient

client = IcebergMCPClient(catalog_type="iceberg.rest", catalog_url="http://your-iceberg-rest-server:8080")

💻 使用例

基本的な使用法

テーブル構造のクエリ

response = client.get_table_schema("my-database", "my-table")
print(response)

パーティション情報の取得

response = client.list_partitions("my-database", "my-table", max_parts=10)
print(response)

📚 詳細ドキュメント

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

• 現在サポートされているカタログタイプ：
  • AWS Glue
  • Apache Iceberg™ REST Catalog（近日公開予定！）

貢献

貢献いただける場合は、いつでもPull Requestを送信してください。