How do I install the iceberg mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `IMPALA_HOST`, `IMPALA_PORT`, `IMPALA_USER`, `IMPALA_PASSWORD`, `IMPALA_DATABASE` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Iceberg MCP Server

This is a A Model Context Protocol server that provides read-only access to Iceberg tables via Apache Impala. This server enables LLMs to inspect

Local serverstdio

What is the Iceberg MCP Server?

This is a A Model Context Protocol server that provides read-only access to Iceberg tables via Apache Impala. This server enables LLMs to inspect database schemas

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Iceberg MCP Server

{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cloudera/iceberg-mcp-server@main",
        "run-server"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "YOUR_IMPALA_PASSWORD",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
IMPALA_HOST	Declared in the maintainer’s client configuration.	Check documentation
IMPALA_PORT	Declared in the maintainer’s client configuration.	Check documentation
IMPALA_USER	Declared in the maintainer’s client configuration.	Check documentation
IMPALA_PASSWORD	Declared in the maintainer’s client configuration.	Check documentation
IMPALA_DATABASE	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Iceberg to Transport.”

Frequently asked questions

This is a A Model Context Protocol server that provides read-only access to Iceberg tables via Apache Impala. This server enables LLMs to inspect database schemas Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.