Iceberg MCP Server (via Impala)

Fornece acesso

Documentação

Cloudera Iceberg MCP Server (via Impala)

Este é um servidor Model Context Protocol que fornece acesso somente leitura a tabelas Iceberg via Apache Impala. Este servidor permite que LLMs inspecionem esquemas de banco de dados e executem consultas somente leitura.

execute_query(query: str): Execute qualquer consulta SQL no Impala e retorne os resultados como JSON.
get_schema(): Liste todas as tabelas disponíveis no banco de dados atual.

Uso com Claude Desktop

Para usar este servidor com o aplicativo Claude Desktop, adicione a seguinte configuração à seção "mcpServers" do seu claude_desktop_config.json:

Opção 1: Instalação direta do GitHub (Recomendado)

{
  "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": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

Opção 2: Instalação local (após clonar o repositório)

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

Para a Opção 2, substitua /path/to pelo caminho para este repositório. Defina as variáveis de ambiente de acordo com a sua configuração do Impala.

Uso com frameworks de IA

A pasta ./examples contém vários exemplos de como integrar este MCP Server com frameworks de IA comuns, como LangChain/LangGraph e OpenAI SDK.

Transporte

O protocolo de transporte do servidor MCP é configurável através da variável de ambiente MCP_TRANSPORT. Valores suportados:

stdio (padrão) — comunica-se por entrada/saída padrão. Útil para ferramentas locais, scripts de linha de comando e integrações com clientes como Claude Desktop.
http — expõe um servidor HTTP. Útil para implantações baseadas na web, microsserviços e exposição de MCP através de uma rede.
sse — usa transporte Server-Sent Events (SSE). Útil para implantações web existentes que dependem de SSE.