README
🚀 冰雹 MCP
冰雹 MCP 是一个为 Apache Iceberg 目录提供支持的 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 桌面集成,可按以下步骤操作:
- 打开
设置>开发者>编辑配置。 - 更新
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
Scan to join WeChat group