morristai/iceberg-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

36 stars 3 forks 质量 55 趋势 12

Repository Install

Apache Iceberg 的 MCP 服务器

概览

一个用于Apache Iceberg目录的MCP服务器，支持异步和日志记录。从发布页面下载最新的预构建二进制文件。要手动构建项目，确保安装了Rust，然后运行：编译后的二进制文件将位于：./target/release/iceberg-mcp 要将 Iceberg MCP 与 Claude Desktop 集成：1. 打开设置>开发者 >编辑配置。2. 用相应配置更新claude_desktop_config.json：

概述（AI 翻译）

一个用于Apache Iceberg目录的MCP服务器，支持异步和日志记录。

冰山MCP演示

支持的目录

目录类型	支持
休息目录	✅
AWS 胶水	✅
蜂巢元存储	❌
第三季表格	❌

支持的工具

工具	说明
`namespaces`	获取冰山目录中的所有命名空间
`tables`	获取给定命名空间的所有表
`table_schema`	返回给定表的模式
`table_properties`	返回给定表的属性

安装

选项1：下载发行二进制

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

选项2：从源头构建

要手动构建项目，确保安装了Rust，然后运行：

编译后的二进制将位于：./target/release/iceberg-mcp

客户端配置

克劳德桌面

要将 Iceberg MCP 与 Claude Desktop 集成：

开 Settings > Developer > Edit Config。
用相应配置更新claude_desktop_config.json：

调试

克劳德桌面

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Iceberg MCP

An MCP server for Apache Iceberg catalogs with async and logging.

Iceberg MCP DEMO

Supported Catalogs

Catalog Type	Supported
Rest Catalogs	✅
AWS Glue	✅
Hive Metastore	❌
S3 Table	❌

Supported Tools

Tools	Description
`namespaces`	Get all namespaces in the Iceberg catalog
`tables`	Get all tables for a given namespace
`table_schema`	Return the schema for a given table
`table_properties`	Return table properties for a given table

Installation

Option 1: Download the Release Binary

Download the latest pre-built binary from the Releases page.

Option 2: Build from Source

To build the project manually, ensure you have Rust installed, then run:

cargo build --release

The compiled binary will be located at: ./target/release/iceberg-mcp

Client Configuration

Claude Desktop

To integrate Iceberg MCP with Claude Desktop:

Open Settings > Developer > Edit Config.
Update claude_desktop_config.json with the appropriate configuration:

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

// use PROFILE_NAME
{
  "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",
        "GLUE_WAREHOUSE": "s3://{bucket_name}",
        "GLUE_ENDPOINT": "http://localhost:9000", // Glue service endpoint, optional
        "LOG_LEVEL": "info"
      }
    }
  }
}

// or use ACCESS_KEY and SECRET_KEY
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "glue",
        "GLUE_WAREHOUSE": "s3a://{bucket_name}",
        "GLUE_ENDPOINT": "http://localhost:9000", // Optional
        "AWS_ACCESS_KEY_ID": "my_access_id",
        "AWS_SECRET_ACCESS_KEY": "my_secret_key",
        "AWS_REGION_NAME": "us-east-1",
        "S3_ENDPOINT": "http://localhost:9000",
        "S3_ACCESS_KEY_ID": "admin",
        "S3_SECRET_ACCESS_KEY": "password",
        "S3_REGION": "us-east-1",
        "LOG_LEVEL": "info"
      }

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

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