Aliyun Alibabacloud Hologres MCP Server

🚀 Hologres MCP 服務器

Hologres MCP 服務器作為 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_sql：執行 Hologres 查詢。
• analyze_table：收集表統計信息。
• get_query_plan：獲取查詢計劃。
• get_execution_plan：獲取執行計劃。

資源

內置資源

• hologres:///schemas：獲取數據庫中的所有架構。

資源模板

• hologres:///{schema}/tables：列出架構中的所有表。
• hologres:///{schema}/{table}/ddl：獲取表的 DDL。
• hologres:///{schema}/{table}/statistic：顯示收集的表統計信息。
• system:///query_log/latest/{row_limits}：獲取最近的查詢日誌。
• system:///query_log/user/{user_name}：獲取特定用戶的查詢日誌。
• system:///query_log/application/{application_name}：獲取特定應用程序的查詢日誌。
• system:///{system_path}：系統路徑包括：
  • missing_stats_tables - 顯示缺少統計信息的表。
  • stat_activity - 顯示當前正在運行的查詢的信息。