日本語 English

Hologres MCP サーバー

ログレス MCP サーバは、AIエージェントとホログレスデータベース間のユニバーサルインターフェイスとして機能します。 AIエージェントとホログレス間のシームレスな通信を可能にし、AIエージェントがホログレスデータベースメタデータを取得し、SQL操作を実行するのに役立ちます。

設定

モード1:ローカルファイルを使用する

ダウンロード

Githubからダウンロード

####MCPの統合

MCP クライアント設定ファイルに次の設定を追加します。

モード 2: PIP モードを使用する

インストール

MCP のインストール 次のパッケージを使用してサーバー:

####MCPの統合

MCP クライアント設定ファイルに次の設定を追加します。

uvモードを使用する

uvxモードを使用する

モード 3: ストリーム可能な HTTP トランスポートを使用する

サーバは、STDIOが利用できなくなったリモート展開のシナリオに対して、ストリーム可能なHTTPトランスポートをサポートしています。

サーバを起動する

サーバを起動する前に、Hologres接続環境変数を設定します。

それからサーバーを始めて下さい:

MCP エンドポイントは [http:// : /mcp] で利用できます。

###Clip オプション

| オプション | デフォルト | 説明 | お問い合わせ | [--transport | [stdio | 輸送タイプ: [[T3], [streamable-http], [sse] |

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