🚀 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 - 显示当前正在运行的查询的信息。