Alibabacloud Hologres MCP Server

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

✨ 主要特性

組件

工具

• 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> - 獲取指定間隔內的失敗查詢日誌歷史記錄，帶有行限制。