Iceberg MCP

What is Iceberg MCP?

Iceberg MCP is an MCP (Model Context Protocol) server for Apache Iceberg catalogs, providing async and logging support. It integrates with Rest and AWS Glue catalogs, and is intended for developers who want to query Iceberg metadata via MCP-compatible clients like Claude Desktop.

How to use Iceberg MCP?

Install by downloading the latest pre-built binary from the Releases page, or build from source using Rust (run cargo build --release). Configure the server via environment variables for the catalog type (CATALOG_KIND: rest or glue) and corresponding credentials. Integrate with Claude Desktop by updating claude_desktop_config.json with the binary path and required environment variables.

Key features of Iceberg MCP

• Supports Rest and AWS Glue Iceberg catalogs
• Provides tools: namespaces, tables, table_schema, table_properties
• Built with async I/O and logging support
• Pre-built binaries available for download
• Compatible with MCP clients like Claude Desktop

Use cases of Iceberg MCP

• List all namespaces in an Iceberg catalog
• Retrieve all tables for a given namespace
• Get the schema of a specific table
• Look up table properties for analysis or governance
• Integrate Iceberg metadata querying into AI-powered assistants

FAQ from Iceberg MCP

What catalogs does Iceberg MCP support?

It supports Rest catalogs and AWS Glue catalogs. Hive Metastore and S3 Table catalogs are not supported.

What tools does Iceberg MCP provide?

The server provides four tools: namespaces, tables, table_schema, and table_properties.

How do I install Iceberg MCP?

You can download a pre-built binary from the Releases page, or build from source with cargo build --release (requires Rust).

How do I configure Iceberg MCP for AWS Glue?

Set CATALOG_KIND=glue and provide either a profile name (PROFILE_NAME) with AWS config/credentials files, or direct access keys (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY) and S3/Glue endpoints as needed.

How can I debug Iceberg MCP when used with Claude Desktop?

View logs by running tail -n 20 -F ~/Library/Logs/Claude/mcp-server-iceberg-mcp.log.