Hologres MCP サーバー

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

構成

モード1: ローカルファイルの使用

ダウンロード

Githubからダウンロード

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

MCP統合

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

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

モード2: PIPモードの使用

インストール

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

pip install hologres-mcp-server

MCP統合

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

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

Related MCP server: MCP PostgreSQL Server

コンポーネント

ツール

execute_select_sql : Hologres サーバーで SELECT SQL クエリを実行する
execute_dml_sql : Hologres サーバーで DML (INSERT、UPDATE、DELETE) SQL クエリを実行します。
execute_ddl_sql : Hologres サーバーで DDL (CREATE、ALTER、DROP) SQL クエリを実行します。
gather_table_statistics : テーブル統計を収集する
get_query_plan : クエリプランを取得する
get_execution_plan : 実行プランを取得する

リソース

組み込みリソース

hologres:///schemas : データベース内のすべてのスキーマを取得する

リソーステンプレート

hologres:///{schema}/tables : スキーマ内のすべてのテーブルを一覧表示する
hologres:///{schema}/{table}/partitions : パーティションテーブルのすべてのパーティションを一覧表示します
hologres:///{schema}/{table}/ddl : テーブル DDL を取得する
hologres:///{schema}/{table}/statistic : 収集されたテーブル統計を表示します
system:///{+system_path} : システムパスには以下が含まれます。
- missing_stats_tables - 統計が欠落しているテーブルを表示します。
- stat_activity - 現在実行中のクエリの情報を表示します。
- query_log/latest/<row_limits> - 指定された行数の最近のクエリログ履歴を取得します。
- query_log/user/<user_name>/<row_limits> - 行制限のある特定のユーザーのクエリログ履歴を取得します。
- query_log/application/<application_name>/<row_limits> - 行制限のある特定のアプリケーションのクエリログ履歴を取得します。
- query_log/failed//<row_limits> - 間隔と指定された行数で失敗したクエリログ履歴を取得します。