MCP冰山目录

用于与 Apache Iceberg 交互的 MCP（模型上下文协议）服务器实现。该服务器提供 SQL 接口，用于通过 Claude 桌面查询和管理 Iceberg 表。

Claude Desktop 作为您的 Iceberg 数据湖目录

Related MCP server: PostgreSQL Query MCP Server

如何在 Claude Desktop 中安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 MCP Iceberg Catalog：

1. 先决条件

   • Python 3.10 或更高版本

   • UV 包安装程序（推荐）或 pip

   • 访问 Iceberg REST 目录和 S3 兼容存储

2. 如何在 Claude Desktop 中安装将以下配置添加到claude_desktop_config.json ：

设计

建筑学

MCP 服务器由三个主要组件构成：

1. MCP 协议处理器

   • 实现模型上下文协议以便与 Claude 进行通信

   • 通过 stdio 处理请求/响应周期

   • 管理服务器生命周期和初始化

2. 查询处理器

   • 使用sqlparse解析 SQL 查询

   • 支持操作：

     • 列表表

     • 描述表

     • 选择

     • 插入

3. 冰山整合

   • 使用pyiceberg进行表操作

   • 与 PyArrow 集成以实现高效的数据处理

   • 管理目录连接和表操作

PyIceberg 集成

该服务器通过多种方式利用 PyIceberg：

1. 目录管理

   • 连接到 REST 目录

   • 管理表元数据

   • 处理命名空间操作

2. 数据操作

   • 在 PyIceberg 和 PyArrow 类型之间转换

   • 通过 PyArrow 表处理数据插入

   • 管理表模式和字段类型

3. 查询执行

   • 将 SQL 转换为 PyIceberg 操作

   • 处理数据扫描和过滤

   • 管理结果集转换

需要进一步实施

1. 查询操作

   • [ ] 实现 UPDATE 操作

   • [ ] 添加删除支持

   • [ ] 支持使用架构定义的 CREATE TABLE

   • [ ] 添加 ALTER TABLE 操作

   • [ ] 实现表分区支持

2. 数据类型

   • [ ] 支持复杂类型（数组、映射、结构体）

   • [ ] 添加带有时区处理的时间戳

   • [ ] 支持十进制类型

   • [ ] 添加嵌套字段支持

3. 性能改进

   • [ ] 实现批量插入

   • [ ] 添加查询优化

   • [ ] 支持并行扫描

   • [ ] 为频繁访问的数据添加缓存层

4. 安全功能

   • [ ] 添加身份验证机制

   • [ ] 实施基于角色的访问控制

   • [ ] 添加行级安全性

   • [ ] 支持加密连接

5. 监控和管理

   • [ ] 添加指标收集

   • [ ] 实现查询日志记录

   • [ ] 添加性能监控

   • [ ] 支持表维护操作

6. 错误处理

   • [ ] 改进错误信息

   • [ ] 添加瞬时故障重试机制

   • [ ] 实现事务支持

   • [ ] 添加数据验证