MCP ExplorerExplorer

Iceberg Mcp

@morristaion a year ago
29 MIT
FreeCommunity
AI Systems
MCP server for Apache Iceberg

Overview

What is Iceberg Mcp

Iceberg MCP is a server designed for managing Apache Iceberg catalogs with asynchronous operations and logging capabilities.

Use cases

Use cases for Iceberg MCP include data catalog management, schema evolution, and querying large datasets efficiently in data lakes.

How to use

To use Iceberg MCP, download the release binary from the GitHub repository or build it from source using Cargo. Configure the client by adding the server details in the Claude Desktop settings.

Key features

Key features include support for various catalogs like Rest, the ability to retrieve namespaces, tables, schemas, properties, and partitions for Iceberg tables.

Where to use

Iceberg MCP can be used in data engineering and analytics environments where Apache Iceberg is implemented for managing large datasets.

Content

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:

  1. Open Settings > Developer > Edit Config.
  2. 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
{
  "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",
        "WAREHOUSE": "s3://{bucket_name}/{namespace}/{table}",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Debugging

Claude Desktop

View logs for troubleshooting with:

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers