Alibabacloud Hologres MCP Server

🚀 Hologres MCP サーバー

Hologres MCP サーバーは、AI エージェントと Hologres データベース間の汎用インターフェースとして機能します。これにより、AI エージェントは Hologres とシームレスに通信でき、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"
      }
    }
  }

📚 ドキュメント

コンポーネント

ツール

• 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/<interval>/<row_limits> - 指定された間隔内の失敗したクエリログ履歴を、行数制限付きで取得します。