Apache Hive MCP Server

Ein MCP-Server für Apache Hive (HiveServer2), erstellt mit FastMCP. Er verbindet sich mit jedem HiveServer2-kompatiblen Endpunkt – Open-Source Apache Hive, Cloudera CDP Base oder Cloudera CDP PublicCloud (CDW) – und stellt zwei schreibgeschützte Tools bereit, die ein LLM-Agent aufrufen kann.

Projektbersicht

• Was es ist – ein Model Context Protocol-Server, der es einem LLM-Agenten erlaubt, Apache Hive abzufragen: Tabellen auflisten und schreibgeschützte SQL ausführen, wobei die Ergebnisse als JSON zurückgegeben werden.

• Feature-Parität – orientiert sich am [Impala/Iceberg MCP-Server] (https://github.com/cloudera/iceberg-mcp-server) – der gleichen execute_query- und get_schema-Tools und -Struktur, mit auf HiveServer2 umgestellter Verbindungsschicht über 4- und/)。 [HIVER] (https://github.com/cloudera/impyla).

• Funktioniert überall, wo HiveServer2 läuft – Open-Source Apache Hive, CDP Base (Kerberos/LDAP,RTP) and CDP Public / CDWermen (Knox, LDAP over TLS). Auth, Transport and TLS werden vollständig über HIVE_*-UMgebungsvariablen gesteuert.

• Standardmäßig sicher – execute_query erzwingt eine Schreibschutz-Präfix-Prüfung (S/S/DESCRIBE/WITH); Schreib- and DDL-Anweisungen werden abgelehnt, htt before a Verbindung geöffnet wird.

• Transport – stdio (Standard), http oder sse, ausgewählt über MCP_TRANSPORT.

• Tech-Stack – Python ≥3.10, FastMCP, impyla, uv. 11 Unit-Tsts (Verbindung gemockt, kein echtes Hive erforderlich).

Related MCP server: Cloudera Iceberg MCP Server

Tokens

Konfiguration

Alle Konfiguration erfolgt über Umgebungsvariablen (oder eine .env-Datei im Projektstamm).

Kopieren Sie .env.example nach .env and tragen Sie Ihre Werte ein.

Deployment-Presets

Lokal / Entwicklung (Docker HiveServer2)

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

CDP Public Cloud (CDW Virtual Warehouse)

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 mit KerberSteid

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

Beschen Sie sich vor dem Start des Servers ein Kerberos-Ticket (kinit).

Start4

# 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

MCP-Client-Konfiguration

MCP-Hosts (likeBlilde Desktop, Clouderatest AI Agent Studio, usw.) regestrieren Server in einem mcpServers- JSON-Block. uvx startet den Server in Deploy automatically from GitHub, no need to local instalation or PyPI-Mublish. Fülle Sie die HIVE_*-Werte for Ihre Umgebung aus (siehe Konfiguration and die obigen Deployment-Presets).

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

Das obige Beispiel zilt auf CDP Public Cloud / CDW. Für lokale oder Kerberos-Ziele, tauschen Sie die env- Werte mithilfe der obigen Presets aus. @v0.1.0 fixiert eine feste Release-Version – Einfernen Sie (sie) um dem neusten Stand zu folgen, orhöhen Sie sie für eine neuere Version.

Speziell für Cloudera 23 AI Agent Studio (Registrierungsschritte, Behandlung von UmgebungsVvariablen, stdio/uvz-Einschränkungen) siehe examples/agent-studio/.

##,Smoke-Test

1. Starten Sie eine echtes HiveServer2 (z. B. das Apache-Hive-Docker-Image):

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

2. Three .env mit the obigen lokalen Preset konfigurieren.

3. Starten Sie den Server:

   uv run hive-mcp-server

4. In einerm zweiten Termziel-ain, verwenden Sie den fastmcp-Dev-Inspektor oder einen beliebigen MCP-Client, um beide Tools aufzurufen:

   • get_schema() – sollte [] oder eine Liste der Tabellenamen zurückgeben.

   • execute_query("SHOW DATABASES") – sollte ein JSON-Array der Datenbanken zurückgeben.

Lizenz

Apache License 2.0 – siehe LICENSE.