hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides a SQL interface for querying and managing Apache Iceberg tables, allowing users to list tables, describe table structures, execute SELECT queries, and insert data into Iceberg data lakes.

MCP冰山目录

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

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

如何在 Claude Desktop 中安装

通过 Smithery 安装

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

npx -y @smithery/cli install @ahodroj/mcp-iceberg-service --client claude

先决条件
- Python 3.10 或更高版本
- UV 包安装程序（推荐）或 pip
- 访问 Iceberg REST 目录和 S3 兼容存储
如何在 Claude Desktop 中安装将以下配置添加到claude_desktop_config.json ：

{
  "mcpServers": {
    "iceberg": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_/mcp-iceberg-service",
        "run",
        "mcp-server-iceberg"
      ],
      "env": {
        "ICEBERG_CATALOG_URI" : "http://localhost:8181",
        "ICEBERG_WAREHOUSE" : "YOUR ICEBERG WAREHOUSE NAME",
        "S3_ENDPOINT" : "OPTIONAL IF USING S3",
        "AWS_ACCESS_KEY_ID" : "YOUR S3 ACCESS KEY",
        "AWS_SECRET_ACCESS_KEY" : "YOUR S3 SECRET KEY"
      }
    }
  }
}

设计

建筑学

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

MCP 协议处理器
- 实现模型上下文协议以便与 Claude 进行通信
- 通过 stdio 处理请求/响应周期
- 管理服务器生命周期和初始化
查询处理器
- 使用sqlparse解析 SQL 查询
- 支持操作：
  - 列表表
  - 描述表
  - 选择
  - 插入
冰山整合
- 使用pyiceberg进行表操作
- 与 PyArrow 集成以实现高效的数据处理
- 管理目录连接和表操作

PyIceberg 集成

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

目录管理
- 连接到 REST 目录
- 管理表元数据
- 处理命名空间操作
数据操作
- 在 PyIceberg 和 PyArrow 类型之间转换
- 通过 PyArrow 表处理数据插入
- 管理表模式和字段类型
查询执行
- 将 SQL 转换为 PyIceberg 操作
- 处理数据扫描和过滤
- 管理结果集转换

需要进一步实施

查询操作
- [ ] 实现 UPDATE 操作
- [ ] 添加删除支持
- [ ] 支持使用架构定义的 CREATE TABLE
- [ ] 添加 ALTER TABLE 操作
- [ ] 实现表分区支持
数据类型
- [ ] 支持复杂类型（数组、映射、结构体）
- [ ] 添加带有时区处理的时间戳
- [ ] 支持十进制类型
- [ ] 添加嵌套字段支持
性能改进
- [ ] 实现批量插入
- [ ] 添加查询优化
- [ ] 支持并行扫描
- [ ] 为频繁访问的数据添加缓存层
安全功能
- [ ] 添加身份验证机制
- [ ] 实施基于角色的访问控制
- [ ] 添加行级安全性
- [ ] 支持加密连接
监控和管理
- [ ] 添加指标收集
- [ ] 实现查询日志记录
- [ ] 添加性能监控
- [ ] 支持表维护操作
错误处理
- [ ] 改进错误信息
- [ ] 添加瞬时故障重试机制
- [ ] 实现事务支持
- [ ] 添加数据验证

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

execute_query

模型上下文协议服务器，提供通过 Claude 桌面查询和管理 Apache Iceberg 表的 SQL 接口，允许与 Iceberg 数据湖进行自然语言交互。