MCP 服务器

Hologres MCP Server

一个通用接口，使AI Agent能够与Hologres数据库进行通信，从而检索数据库元数据并执行SQL操作。

Tools

execute_select_sql

Execute SELECT SQL to query data from Hologres database.

execute_dml_sql

Execute (INSERT, UPDATE, DELETE) SQL to insert, update, and delete data in Hologres databse.

execute_ddl_sql

Execute (CREATE, ALTER, DROP) SQL statements to CREATE, ALTER, or DROP tables, views, procedures, GUCs etc. in Hologres databse.

gather_table_statistics

Execute the ANALYZE TABLE command to have Hologres collect table statistics, enabling QO to generate better query plans

get_query_plan

Get query plan for a SQL query

get_execution_plan

Get actual execution plan with runtime statistics for a SQL query

README

Hologres MCP 服务器

Hologres MCP 服务器充当 AI Agent 和 Hologres 数据库之间的通用接口。它实现了 AI Agent 和 Hologres 之间的无缝通信，帮助 AI Agent 检索 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 客户端配置文件：

"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: 获取数据库中的所有 schema

资源模板

hologres:///{schema}/tables: 列出 schema 中的所有表
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> - 获取指定时间间隔和行数限制的失败查询日志历史记录。