Korean | 한국어

MCP 서버 Hologres

다운로드 서버는 AI Agents와 Hologres 데이터베이스 간의 범용 인터페이스 역할을 합니다. AI Agents와 Hologres 사이의 원활한 통신을 가능하게하며 AI Agents는 Hologres 데이터베이스 메타데이터를 검색하고 SQL 작업을 수행합니다.

구성

모드 1: 로컬 파일 사용

다운로드

Github에서 다운로드

MCP 통합

MCP 클라이언트 구성 파일에 다음 구성 추가:

형태 2: PIP 형태 사용하기

설치

MCP 설치 다음 패키지를 사용하여 서버:

MCP 통합

MCP 클라이언트 구성 파일에 다음 구성 추가:

uv 형태를 사용하십시오

uvx 모드 사용

형태 3: Streamable HTTP 수송 사용하기

서버는 STDIO가 사용할 수없는 원격 배포 시나리오에 대한 스트리밍 HTTP 전송을 지원합니다.

서버 시작

서버를 시작하기 전에 Hologres 연결 환경 변수를 설정하십시오.

그런 다음 서버를 시작합니다.

MCP 엔드포인트는 http:// : /mcp에서 사용할 수 있습니다.

CLI 옵션

English | 中文

Hologres MCP Server

Hologres MCP Server serves as a universal interface between AI Agents and Hologres databases. It enables seamless communication between AI Agents and Hologres, helping AI Agents retrieve Hologres database metadata and execute SQL operations.

Configuration

Mode 1: Using Local File

Download

Download from Github

git clone https://github.com/aliyun/alibabacloud-hologres-mcp-server.git

MCP Integration

Add the following configuration to the MCP client configuration file:

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/alibabacloud-hologres-mcp-server",
                "run",
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "database"
            }
        }
    }
}

Mode 2: Using PIP Mode

Installation

Install MCP Server using the following package:

pip install hologres-mcp-server

MCP Integration

Add the following configuration to the MCP client configuration file:

Use uv mode

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "hologres-mcp-server",
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "database"
            }
        }
    }
}

Use uvx mode

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uvx",
            "args": [
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "database"
            }
        }
    }
}

Mode 3: Using Streamable HTTP Transport

The server supports Streamable HTTP transport for remote deployment scenarios where STDIO is not available.

Start the server

Before starting the server, set the Hologres connection environment variables:

export HOLOGRES_HOST="your-hologres-instance.hologres.aliyuncs.com"
export HOLOGRES_PORT="80"
export HOLOGRES_USER="your_access_id"
export HOLOGRES_PASSWORD="your_access_key"
export HOLOGRES_DATABASE="your_database"

Then start the server:

# Using pip-installed package