Apache Hive MCP Server

Apache Hive(HiveServer2)용 MCP 서버로, FastMCP로 구축되었습니다. 오소스 Apache Hive, Cloudera CDPlela CDP Base, Cloudera CDP Public Cloud(CDW) 등 HiveServer2호환 엔드포인트에 무엇이든 연결할 수 있으며, LLM 에이전트가 호출할 수 있는 두 가지 N기 전용 도구를 노출합니다.

프로젝트 요약

• 정의 — LLM 에이전트가 Apache Hive를 리할 수 있는 Model Context Protocol 서버입니다: 테이블을 읽 조회하고 N기 전용 SQL를 실행하며, 결과과는 JSON로 반환됩니다.

• 기능 동등성 — Cloudera의 [Impala/Iceberg MCP server|https://github.com/cloudera/ceberg-mcP-server)|동일한 execute_query + get_schema 도구와 구조를 가지며, 연결 계층은[impyla|https://github.com/cloudera/impyla)를 통해 HiveServer2로 교체되었습니다.

• HiveServer2가 지원되되는 모든 곳에서 동작 — 오소스 Apache Hive(, CDP Base(Kerberos/LDAP), CDP Public Cloud / CDW(, Knox, HTTPS LDAP 등. 인증, 전송, TLS Db는 모두 HIVE_* 환경변홖로 제어됩니다.

• 기본적으로 안전 — execute_query는 읽기 전용 접두 고드(SELECT/SHOW/DESCRIBE/WITH)를 적용하며, 쓰기/DDL 문은 연결 전에 거부됩니다.

• 전송 방식 — stdio(기본값), http, sse 중 선택하며, MCP_TRANSPORT로 지정합니다.

• 기술 스택 — Python ≥3.10, FastMCP, impyla, uv. 단위 테스트 11개(연결은 목업 처리 — 라이브 Hive 불필요).

Related MCP server: Cloudera Iceberg MCP Server

도구

구성

모든 구성은 환경 변수(또는 프로젝트 루트의 .env 파일)로 지정합니다.

.env.example을 .env로 복사한 후 값을 입력하세요.

배포 프리셋

로컬 / 개발(Docker HiveServer2)

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

CDP Public Cloud(CDW 가상 웨어하우스)

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 / 온프레미스(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

서버를 시작하기 전에 Kerberos 티켓(kinit)을 발급받으세요.

실행

# 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 클라이언트 구성

MCP 호스트(Claude Desktop, Cloudera AI Agent Studio 등)는 mcpServers JSON 블록으로 서버를 등록합니다. uvx는 이 서버를 GitHub에서 직접 실행합니다 — 로컬 설치나 PyPI 배포가 필요 없습니다. 환경에 맞게 HIVE_* 값을 채우세요(구성 및 위 프리셋 참조).

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

위 예제는 CDP Public Cloud / CDW를 대상으로 합니다. 로컬 또는 Kerberos 타겟의 경우 위 프리셋을 사용하여 env 값만 바꾸면 됩니다. @v0.1.0은 특정 릴리스를 고정합니다 — 제거하면 최신 버전을 추적하고, 더 새 버전으로 올릴 수도 있습니다.

Cloudera AI Agent Studio의 경우(등록 절차, 환경 변수 처리, stdio/uvx 제약 사항)에는 examples/agent-studio/를 참조하세요.

스모크 테스트

1. 로컬 HiveServer2 시작(예: Apache Hive Docker 이미지):

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

2. 위 로컬 프리셋으로 .env을 구성합니다.

3. 서버 시작:

   uv run hive-mcp-server

4. 두 번째 터미널에서 fastmcp 개발 인스펙터 또는 아무 MCP 클라이언트로 두 도구를 호출해 보세요:

   • get_schema() — [] 또는 테이블 이름 목록을 반환해야 합니다.

   • execute_query("SHOW DATABASES") — 데이터베이스 목록의 콸 JSON 배열을 반환해야 합니다.

라이선

• 라/이선스: See LICENSE.

라이선스

Apache License 2 — LICENSE를 참조하세요.

라이선스

Apache License 2.0 — LICENSE를 참조하세요.

라이선스

Apache License 2.0 — LICENSE를 참조하세요.