Hologres MCP Server

基本能力

产品定位

Hologres MCP Server 是一个数据库中间件，专门用于连接 AI Agents 和 Hologres 数据库，提供数据库操作和元数据查询功能。

核心功能

1. SQL 操作：支持执行 SELECT、DML（INSERT, UPDATE, DELETE）和 DDL（CREATE, ALTER, DROP）SQL 查询。
2. 元数据查询：提供数据库元数据查询功能，如获取表结构、分区信息等。
3. 性能分析：支持收集表统计信息、获取查询计划和执行计划。
4. 资源管理：内置多种资源模板，用于查询数据库状态和日志。

适用场景

1. AI Agents 集成：为 AI Agents 提供数据库操作能力，支持复杂的数据查询和更新。
2. 数据库管理：用于数据库管理员或开发者进行数据库元数据查询和性能分析。
3. 自动化运维：通过自动化脚本或工具进行数据库监控和日志分析。

工具列表

1. execute_select_sql：执行 SELECT SQL 查询。
2. execute_dml_sql：执行 DML SQL 查询（INSERT, UPDATE, DELETE）。
3. execute_ddl_sql：执行 DDL SQL 查询（CREATE, ALTER, DROP）。
4. gather_table_statistics：收集表统计信息。
5. get_query_plan：获取查询计划。
6. get_execution_plan：获取执行计划。

常见问题解答

暂无提供。

使用教程

使用依赖

1. 确保已安装 Python 和 pip。
2. 确保已安装 Git（如果使用本地文件模式）。

安装教程

模式 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"
    ],
    "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"
      }
    }
  }

调试方式

1. 确保环境变量（如 HOLOGRES_HOST、HOLOGRES_PORT 等）已正确配置。
2. 运行服务后，可以通过工具列表中的命令测试功能是否正常。

许可证

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