Hologres MCP Server

基本能力

产品定位

Hologres MCP Server 是一个通用的接口服务，用于连接AI代理和Hologres数据库。

核心功能

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

适用场景

• AI代理需要访问Hologres数据库的场景
• 需要执行SQL查询并分析结果的场景
• 需要获取数据库元数据和统计信息的场景

工具列表

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

常见问题解答

• 默认运行在SSE模式，可以通过--transport参数指定模式
• 需要通过环境变量配置Hologres数据库连接信息

使用教程

使用依赖

• Python 3.10或更高版本
• uv 用于包管理

安装教程

方法1: 使用本地仓库

1. 克隆仓库:

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

1. 在MCP客户端配置文件中添加配置:

"mcpServers": {
  "hologres-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/alibabacloud-hologres-mcp-server",
      "run",
      "hologres-mcp-server",
      "--transport",
      "sse"  // 或 "stdio" 用于STDIO模式
    ],
    "env": {
      "HOLOGRES_HOST": "host",
      "HOLOGRES_PORT": "port",
      "HOLOGRES_USER": "access_id",
      "HOLOGRES_PASSWORD": "access_key",
      "HOLOGRES_DATABASE": "database",
      "SERVER_HOST": "0.0.0.0",  // 仅SSE模式需要
      "SERVER_PORT": "8001"      // 仅SSE模式需要
    }
  }
}

方法2: 使用PIP安装

1. 安装MCP Server包:

pip install hologres-mcp-server

1. 在MCP客户端配置文件中添加配置:

"mcpServers": {
  "hologres-mcp-server": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "hologres-mcp-server",
      "hologres-mcp-server",
      "--transport",
      "sse"  // 或 "stdio" 用于STDIO模式
    ],
    "env": {
      "HOLOGRES_HOST": "host",
      "HOLOGRES_PORT": "port",
      "HOLOGRES_USER": "access_id",
      "HOLOGRES_PASSWORD": "access_key",
      "HOLOGRES_DATABASE": "database",
      "SERVER_HOST": "0.0.0.0",  // 仅SSE模式需要
      "SERVER_PORT": "8001"      // 仅SSE模式需要
    }
  }
}

调试方式

在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

# 以STDIO传输模式运行服务器
hologres-mcp-server --transport stdio

许可证

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