Iceberg MCP Server (via Impala)

Proporciona acceso de solo lectura a tablas Apache Iceberg a través de Apache Impala, permitiendo que los LLMs inspeccionen esquemas y ejecuten consultas.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Cloudera Iceberg (vía Impala)

Este es un servidor de Model Context Protocol que proporciona acceso de solo lectura a tablas Iceberg mediante Apache Impala. Este servidor permite a los LLM inspeccionar esquemas de bases de datos y ejecutar consultas de solo lectura.

execute_query(query: str): Ejecutar cualquier consulta SQL en Impala y devolver los resultados como JSON.
get_schema(): Listar todas las tablas disponibles en la base de datos actual.

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json:

Opción 1: Instalación directa desde GitHub (Recomendada)

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

Opción 2: Instalación local (después de clonar el repositorio)

{
  "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 la Opción 2, reemplace /path/to con su ruta a este repositorio. Configure las variables de entorno de acuerdo con su configuración de Impala.

Uso con frameworks de IA

La carpeta ./examples contiene varios ejemplos de cómo integrar este MCP Server con frameworks de IA comunes como LangChain/LangGraph, OpenAI SDK.

Transporte

El protocolo de transporte del servidor MCP es configurable mediante la variable de entorno MCP_TRANSPORT. Valores admitidos:

stdio (predeterminado) — comunicarse a través de entrada/salida estándar. Útil para herramientas locales, scripts de línea de comandos e integraciones con clientes como Claude Desktop.
http — exponer un servidor HTTP. Útil para implementaciones basadas en web, microservicios, exponer MCP a través de una red.
sse — usar transporte de Server-Sent Events (SSE). Útil para implementaciones web existentes que dependen de SSE.