英文 | 中文

Hologres MCP 服务器

Hologres MCP 服务器充当 AI 智能体与 Hologres 数据库之间的通用接口。它实现了 AI 智能体与 Hologres 之间的无缝通信，帮助智能体检索 Hologres 数据库元数据并执行 SQL 操作。

配置方式

模式一：使用本地文件

下载

从 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": "主机地址",
                "HOLOGRES_PORT": "端口号",
                "HOLOGRES_USER": "访问ID",
                "HOLOGRES_PASSWORD": "访问密钥",
                "HOLOGRES_DATABASE": "数据库名"
            }
        }
    }
}

模式二：使用 PIP 安装模式

安装

通过以下命令安装 MCP 服务器：

pip install hologres-mcp-server

MCP 集成配置

在 MCP 客户端配置文件中添加以下内容：

使用 uv 模式：

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "hologres-mcp-server",
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "主机地址",
                "HOLOGRES_PORT": "端口号",
                "HOLOGRES_USER": "访问ID",
                "HOLOGRES_PASSWORD": "访问密钥",
                "HOLOGRES_DATABASE": "数据库名"
            }
        }
    }
}

使用 uvx 模式：

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uvx",
            "args": [
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "主机地址",
                "HOLOGRES_PORT": "端口号",
                "HOLOGRES_USER": "访问ID",
                "HOLOGRES_PASSWORD": "访问密钥",
                "HOLOGRES_DATABASE": "数据库名"
            }
        }
    }
}

组件功能

工具命令

• execute_hg_select_sql：在 Hologres 数据库中执行 SELECT SQL 查询
• execute_hg_select_sql_with_serverless：使用无服务器计算模式执行 Hologres 数据库的 SELECT SQL 查询
• execute_hg_dml_sql：在 Hologres 数据库中执行 DML（INSERT、UPDATE、DELETE）SQL 查询
• execute_hg_ddl_sql：在 Hologres 数据库中执行 DDL（CREATE、ALTER、DROP、COMMENT ON）SQL 查询
• gather_hg_table_statistics：收集 Hologres 数据库中的表统计信息
• get_hg_query_plan：获取 Hologres 数据库中的查询计划
• get_hg_execution_plan：获取 Hologres 数据库中的执行计划
• call_hg_procedure：调用 Hologres 数据库中的存储过程
• create_hg_maxcompute_foreign_table：在 Hologres 数据库中创建 MaxCompute 外部表

由于部分智能体不支持资源和资源模板，以下工具提供了获取模式、表、视图和外部表元数据的功能：

• list_hg_schemas：列出当前 Hologres 数据库中的所有模式（不包括系统模式）
• list_hg_tables_in_a_schema：列出指定模式中的所有表（包括表类型：普通表、视图、外部表、分区表）
• show_hg_table_ddl：显示 Hologres 数据库中表、视图或外部表的 DDL 脚本

资源定义

内置资源

• hologres:///schemas：获取 Hologres 数据库中的所有模式

资源模板

• hologres:///{schema}/tables：列出 Hologres 数据库中指定模式的所有表

• hologres:///{schema}/{table}/partitions：列出 Hologres 数据库中指定分区表的所有分区

• hologres:///{schema}/{table}/ddl：获取 Hologres 数据库中表的 DDL 定义

• hologres:///{schema}/{table}/statistic：显示 Hologres 数据库中收集的表统计信息

• system:///{+system_path}： 系统路径包括：

  • hg_instance_version - 显示 Hologres 实例版本信息
  • guc_value/<guc_name> - 显示 GUC（Grand Unified Configuration）参数值
  • 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> - 获取指定时间间隔内失败的查询日志历史（限制行数）

提示模板

当前无可用提示模板