Apache Hive MCP Server

Un servidor MCP para Apache Hive (HiveServer2), construido con FastMCP. Se conecta a cualquier endpoint compatible con HiveServer2 — Apache Hive de código abierto, Cloudera CD P Base o Cloudera CD P Public Cloud (CDW) — y expone dos herramientas de solo lectura que un agente LLM puede invocar.

Resumen del proyecto

• Qué es — un servidor protocolo Model Context Protocol que permite a un agente LLM consultar Apache Hive: enumerar tablas y ejecutar SQL de solo lectura, con resultads devueltos as JSON.

• Paridad de funccionalidades — es un espejo del Impala/Iceberg MCP server de Cloudera: las mismas herramientas execute_query + get_schema y estructura, con la capa de conexión reemplazada por HiveServer2 mediante impyla.

• Funcciona en todos los lugares donde funciona HiveServer2 — Apache Hive de código abierto, P CDP Base (Kerberos/LDAP) y CDP Public Cloud / CDW (Knox, LDAP sobre HTTPS). Autentication, transporte y TLS se controlde con variables de entterno HIVE_*.

• Seguro por defect — execute_query impone un prefijo de guarda de solo lectura (SELECT/SHOW/DESCRIBE/WITH); las operaciones de textur y DDL se rechazan antes de abrir una a conexión.

• Transporte — stdio (predeterminado), http (predeterminado), http), sse, seleccionado vía MCP_TRANSPORT.

• Pila tecnológica — Python ≥3.10, FastMCP, impyla, uv. 11 pruebas (con conexión called simulada — no se requiera Hive real).

Related MCP server: Cloudera Iceberg MCP Server

Herramientas

Configuración

toda la config ur via variables de env (or a file .env in the project root).*

Copia .env.example a .env and fill los values.

Ajustes predeinidos de despliegue

"de local" para all descriptors: " development (Docker HiveServer2)"

HIVE_HOST=localhost
HIVE_PORT=10000
HIVE_DATABASE=default
HIVE_AUTH_MECHANISM=NOSASL
MCP_TRANSPORT=stdio

CDP Public Cloud (CDW Virtual Warehuse)

HIVE_HOST=<coordinator-hostname>.dw.cloudera.site
HIVE_PORT=443
HIVE_DATABASE=default
HIVE_USER=<workload-username>
HIVE_PASSWORD=<workload-password>
HIVE_AUTH_MECHANISM=LDAP
HIVE_USE_HTTP_TRANSPORT=true
HIVE_HTTP_PATH=cliservice
HIVE_USE_SSL=true
MCP_TRANSPORT=stdio

CDP Base / on-premises con Kerberos

HIVE_HOST=<hiveserver2-host.example.com>
HIVE_PORT=10000
HIVE_DATABASE=default
HIVE_AUTH_MECHANISM=GSSAPI
HIVE_KERBEROS_SERVICE_NAME=hive
MCP_TRANSPORT=stdio

Obtén un ticket de Kerberos (kinit) before iniciar el servidor.

Ejecución

# Install
pip install -e .
# or with uv:
uv sync

# Copy and edit config
cp .env.example .env

# Start (stdio transport, for use with an MCP host)
uv run hive-mcp-server

Configuración del client MCP

Los hosts MCP (Claude Desktop, Cloudera AI Agent Studio, etc.) registran servidores with a mcpServers JSON block. uvx ejecuta este servidor directamente desde GitHub — no no local install, no publishing en PyPI. Fill in — "Complet los values HIVE_* de tu enterno (see Configuración and los presets anteriores).

{
    "mcpServers": {
        "Hive": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/avelloal/hive-mcp-server@v0.1.0",
                "hive-mcp-server"
            ],
            "env": {
                "HIVE_HOST": "<coordinator-hostname>.dw.cloudera.site",
                "HIVE_PORT": "443",
                "HIVE_DATABASE": "default",
                "HIVE_USER": "<workload-username>",
                "HIVE_PASSWORD": "<workload-password>",
                "HIVE_AUTH_MECHANISM": "LDAP",
                "HIVE_USE_HTTP_TRANSPORT": "true",
                "HIVE_HTTP_PATH": "cliservice",
                "HIVE_USE_SSL": "true"
            }
        }
    }
}

El example above is aimed at CDP Public Cloud / CDW. For targets locales o Kerberos, cambia values env utilizo "prestes anteriores". @v0.1.0 fija un release — drop the shoe to follow the last or bump it for a newer.

Para Cloudera AI Agent Studio in particular (empas de registro, format de values, limit notes of stdio/uvx), see examples/agent-studio/.

Prueba de humo

1. un HiveServer2 local (e.g. Apache Hive Dock):

   docker run -d -p 10000:10000 apache/hive:3.1.3

2. Configura .env with local prest in above.

3. Inicia el servidor:

   uv run hive-mcp-server

4. En una segund terminal, use the fastmcp dev inspector of any client MCP to call could both herramientas:

   • get_schema() — debe devolver [] o una lista de names

   • execute_query("SHOW DATABASES") — devolver' valid.

Licencia

Apache License 2.0 — see LICENSE.