Iceberg MCP

一个用于 Apache Iceberg catalog 的 MCP 服务器，具有异步和日志记录功能。

支持的 Catalog 类型

Catalog 类型	支持情况
Rest Catalogs	✅
AWS Glue	✅
Hive Metastore	❌
S3 Table	❌

支持的工具

工具	描述
namespaces	获取 Iceberg catalog 中的所有 namespace
tables	获取给定 namespace 的所有 table
table_schema	返回给定 table 的 schema
table_properties	返回给定 table 的 table properties

安装

选项 1：下载 Release 二进制文件

从 Releases 页面 下载最新的预构建二进制文件。

选项 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 Catalogs

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

• AWS Glue Catalogs

{
  "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",
        "WAREHOUSE": "s3://{bucket_name}/{namespace}/{table}",
        "LOG_LEVEL": "info"
      }
    }
  }
}

调试

Claude Desktop

使用以下命令查看日志以进行故障排除：

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