Hologres MCP Server

基本能力

产品定位

Hologres MCP Server 是一个通用的 AI Agents 与 Hologres 数据库之间的接口服务，支持多种传输模式（STDIO、SSE、HTTP Stream），提供数据库元数据访问、SQL 执行、统计管理、查询规划等功能，帮助 AI Agents 无缝连接和操作 Hologres 数据库。

核心功能

• 多种传输模式支持：支持 STDIO、SSE 或 HTTP Stream 模式运行
• 数据库元数据访问：获取数据库的 schema 和表信息
• SQL 执行：执行 SQL 查询并分析结果
• 统计管理：收集和查看表统计信息
• 查询规划：获取查询计划和执行计划

适用场景

• AI Agents 与 Hologres 数据库的交互
• 数据库元数据查询和管理
• SQL 查询执行和结果分析
• 数据库性能优化和查询规划

工具列表

• execute_sql: 在 Hologres 中执行查询
• analyze_table: 收集表统计信息
• get_query_plan: 获取查询计划
• get_execution_plan: 获取执行计划

常见问题解答

• 如何选择传输模式？
• STDIO 模式适用于传统命令行工具，SSE 和 HTTP Stream 模式适用于 Web 应用和云环境。
• 如何配置数据库连接？
• 通过环境变量 HOLOGRES_HOST、HOLOGRES_PORT、HOLOGRES_USER、HOLOGRES_PASSWORD、HOLOGRES_DATABASE 配置。
• 如何运行服务器？
• 使用 hologres-mcp-server 命令，并通过 --transport 参数指定传输模式。

使用教程

使用依赖

• Python 3.10 或更高版本
• uv 包管理工具

安装教程

方法 1: 使用本地仓库

1. 克隆仓库：

git clone https://github.com/aliyun/alibabacloud-hologres-mcp-server.git

1. 配置 MCP 客户端配置文件（详见 README）。

方法 2: 使用 PIP 安装

1. 安装 MCP Server 包：

pip install hologres-mcp-server

1. 配置 MCP 客户端配置文件（详见 README）。

调试方式

运行在 SSE 模式（默认）

export HOLOGRES_HOST=your_host
export HOLOGRES_PORT=your_port
export HOLOGRES_USER=your_user
export HOLOGRES_PASSWORD=your_password
export HOLOGRES_DATABASE=your_database
export SERVER_HOST=0.0.0.0
export SERVER_PORT=8001
hologres-mcp-server

运行在 STDIO 模式

export HOLOGRES_HOST=your_host
export HOLOGRES_PORT=your_port
export HOLOGRES_USER=your_user
export HOLOGRES_PASSWORD=your_password
export HOLOGRES_DATABASE=your_database
hologres-mcp-server --transport stdio

运行在 HTTP Stream 模式

export HOLOGRES_HOST=your_host
export HOLOGRES_PORT=your_port
export HOLOGRES_USER=your_user
export HOLOGRES_PASSWORD=your_password
export HOLOGRES_DATABASE=your_database
export SERVER_HOST=0.0.0.0
export SERVER_PORT=8001
hologres-mcp-server --transport http-stream

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。