Iceberg MCP Server

🚀 Cloudera Iceberg MCP Server (via Impala)

This is a Model Context Protocol (MCP) server that provides read - only access to Apache Iceberg tables through Apache Impala. This server enables Large Language Models (LLMs) to examine database schemas and execute read - only queries.

✨ Features

• execute_query(query: str): Run any SQL query on Impala and return the results in JSON format.
• get_schema(): List all available tables in the current database.

🚀 Quick Start

💻 Usage Examples

Usage with Claude Desktop

To use this server in the Claude Desktop application, add the following configuration to the "mcpServers" section of the claude_desktop_config.json file:

{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/iceberg-mcp-server",
        "run",
        "server.py"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

Replace /path/to with your actual path and set the environment variables.

Usage with AI Frameworks

The ./examples folder contains multiple examples demonstrating how to integrate this MCP server with common AI frameworks such as LangChain/LangGraph and the OpenAI SDK.

📄 License

Copyright (c) 2025 - Cloudera, Inc. All rights reserved.