English | 中文

Hologres MCP Server

Hologres MCP Server 是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 Server：

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": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "database"
            }
        }
    }
}

使用uvx模式

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uvx",
            "args": [
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "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（大统一配置）值。
  • 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> - 获取失败的查询日志历史记录，带有间隔和指定行数。

提示

目前没有提示。