Alibabacloud Hologres Mcp Server

🚀 Hologres MCP 服务器

Hologres MCP 服务器是 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 服务器：

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：获取数据库中的所有架构。

资源模板

• hologres:///{schema}/tables：列出架构中的所有表。
• hologres:///{schema}/{table}/partitions：列出分区表的所有分区。
• hologres:///{schema}/{table}/ddl：获取表的 DDL。
• hologres:///{schema}/{table}/statistic：显示已收集的表统计信息。
• system:///{+system_path}：系统路径说明如下：
  • missing_stats_tables - 显示缺少统计信息的表格。
  • stat_activity - 显示当前正在运行查询的信息。
  • query_log/latest/ - 获取指定行数的最近查询日志历史记录。
  • query_log/user// - 获取特定用户的查询日志历史记录，带有行限制。
  • query_log/application// - 获取特定应用程序的查询日志历史记录，带有行限制。
  • query_log/failed// - 获取指定间隔内的失败查询日志历史记录，带有行限制。