Hologres MCP Server

Hologres MCP Server

site icon
2025.04.04 0
Python数据库中间件AI代理接口数据库
Hologres MCP Server 是一个通用的接口服务,用于连接AI代理和Hologres数据库。它实现了AI代理与Hologres数据库之间的无缝通信,帮助AI代理获取Hologres数据库的元数据并执行SQL操作。
View on GitHub

Overview

基本能力

产品定位

Hologres MCP Server 是一个中间件服务,旨在为AI代理提供与Hologres数据库交互的能力。

核心功能

  • 提供AI代理与Hologres数据库之间的通信接口
  • 支持获取Hologres数据库的元数据
  • 支持执行SQL操作
  • 提供查询计划和执行计划的获取功能
  • 支持表统计信息的收集

适用场景

  • AI代理需要访问Hologres数据库的场景
  • 需要自动化执行SQL查询的场景
  • 需要获取数据库元数据或统计信息的场景

工具列表

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

常见问题解答

暂无

使用教程

使用依赖

无特殊依赖,只需安装Python和pip。

安装教程

模式1:使用本地文件

  1. 从GitHub下载项目:
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"
    ],
    "env": {
      "HOLOGRES_HOST": "host",
      "HOLOGRES_PORT": "port",
      "HOLOGRES_USER": "access_id",
      "HOLOGRES_PASSWORD": "access_key",
      "HOLOGRES_DATABASE": "database"
    }
  }
}

模式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"
    ],
    "env": {
      "HOLOGRES_HOST": "host",
      "HOLOGRES_PORT": "port",
      "HOLOGRES_USER": "access_id",
      "HOLOGRES_PASSWORD": "access_key",
      "HOLOGRES_DATABASE": "database"
    }
  }
}

调试方式

安装完成后,可以通过执行SQL查询或获取数据库元数据来测试服务是否正常工作。例如,使用execute_sql工具执行一个简单的查询。

许可证

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