Cloudera Iceberg MCP Server (via Impala)

Name: Cloudera Iceberg MCP Server (via Impala)
Author: peterableda

@peterableda

Repository

About Cloudera Iceberg MCP Server (via Impala)

Cloudera Iceberg MCP Server via Impala

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Cloudera Iceberg MCP Server (via Impala)?

A Model Context Protocol server that provides read-only access to Iceberg tables via Apache Impala. It enables LLMs to inspect database schemas and execute read-only SQL queries.

How to use Cloudera Iceberg MCP Server (via Impala)?

Configure it in Claude Desktop as an MCP server by adding a JSON entry to claude_desktop_config.json with uv run server.py and environment variables (IMPALA_HOST, IMPALA_PORT, IMPALA_USER, IMPALA_PASSWORD, IMPALA_DATABASE). Example integrations for LangChain/LangGraph and OpenAI SDK are included in the ./examples folder.

Key features of Cloudera Iceberg MCP Server (via Impala)

execute_query: Run any SQL query on Impala and return results as JSON.
get_schema: List all tables available in the current database.
Read‑only access to Iceberg tables.
Designed for LLM integration (Claude Desktop, LangChain, OpenAI SDK).
Uses Impala as the query engine.

Use cases of Cloudera Iceberg MCP Server (via Impala)

Allow an LLM to discover table schemas in an Iceberg data lake.
Query Iceberg tables with natural language through an LLM agent.
Integrate read‑only SQL access into AI‑powered data analysis workflows.
Validate data or run ad‑hoc analytics without granting write permissions.

FAQ from Cloudera Iceberg MCP Server (via Impala)

What data sources does this server work with?

It works with any Iceberg table that is accessible via an Apache Impala cluster. You must provide the Impala host, port, credentials, and a target database.

Is the server read‑only?

Yes. The server only exposes execute_query (any SQL) and get_schema; the README explicitly states it provides “read‑only access to Iceberg tables.”

What runtime does the server require?

The server is distributed as a Python script and launched with uv. It requires Python and the uv package manager installed on the machine running the MCP host (e.g., Claude Desktop).

How do I authenticate to Impala?

Authentication is done via environment variables: IMPALA_USER and IMPALA_PASSWORD. The server does not support other authentication methods as described in the README.