Back to MCP directory
publicPublicdnsLocal runtime

Iceberg

Iceberg MCP是一个为Apache Iceberg目录提供MCP协议支持的服务器,支持异步操作和日志记录,兼容REST和AWS Glue目录。

article

README

🚀 冰雹 MCP

冰雹 MCP 是一个为 Apache Iceberg 目录提供支持的 MCP 服务器,具备异步和日志功能,能有效提升系统的性能和可维护性。

点击查看冰雹 MCP 演示

✨ 主要特性

  • 支持多种目录类型,满足不同用户的使用需求。
  • 提供丰富的工具,方便用户对目录和表进行管理。
  • 具备异步和日志功能,提升系统性能和可维护性。

📦 安装指南

选项 1:下载发行版二进制文件

你可以从 发布页面 下载最新的预编译二进制文件,这种方式简单便捷,适合快速安装使用。

选项 2:从源码构建

若你想手动构建项目,请确保已安装 Rust,然后运行以下命令:

cargo build --release

编译后的可执行文件将位于:./target/release/iceberg-mcp

📚 详细文档

支持的目录类型

| 目录类型 | 是否支持 | |----------------|----------| | Rest Catalogs | ✅ | | AWS Glue | ✅ | | Hive Metastore | ❌ | | S3 表 | ❌ |

支持的工具

| 工具 | 描述 | |--------------------|----------------------------------------| | namespaces | 获取冰雹目录中的所有命名空间 | | tables | 为指定命名空间获取所有表 | | table_schema | 返回指定表的模式 | | table_properties | 返回指定表的属性 |

客户端配置

集成到 Claude 桌面

要将冰雹 MCP 与 Claude 桌面集成,可按以下步骤操作:

  1. 打开 设置 > 开发者 > 编辑配置
  2. 更新 claude_desktop_config.json 文件,添加以下配置:
  • Rest Catalogs
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "二进制文件路径/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "rest",
        "REST_URI": "http://localhost:8080",
        "LOG_LEVEL": "info"
      }
    }
  }
}
  • AWS Glue Catalogs
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "二进制文件路径/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 桌面

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

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client