Iceberg MCP

🚀 IcebergMCP

IcebergMCP 是一個基於 AI 的 Lakehouse 集成項目，它是一個 模型上下文協議 (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。

📄 許可證

查看 許可證 瞭解更多信息。