английский |中文

Сервер MCP Hologres

Hologres MCP Server служит универсальным интерфейсом между агентами ИИ и базами данных Hologres. Он обеспечивает бесперебойную связь между агентами ИИ и Hologres, помогая агентам ИИ извлекать метаданные базы данных Hologres и выполнять операции SQL.

Конфигурация

Режим 1: использование локального файла

Скачать

Загрузить с Github

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

Интеграция МКП

Добавьте следующую конфигурацию в файл конфигурации клиента 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 Server, используя следующий пакет:

pip install hologres-mcp-server

Интеграция МКП

Добавьте следующую конфигурацию в файл конфигурации клиента 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"
            }
        }
    }
}

Использовать режим uvx

{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uvx",
            "args": [
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "database"
            }
        }
    }
}

Related MCP server: MCP PostgreSQL Server

Компоненты

Инструменты

execute_hg_select_sql : выполнение запроса SELECT SQL в базе данных Hologres
execute_hg_select_sql_with_serverless : выполнение запроса SELECT SQL в базе данных Hologres с помощью вычислений без сервера
execute_hg_dml_sql : выполнение SQL-запроса DML (INSERT, UPDATE, DELETE) в базе данных Hologres
execute_hg_ddl_sql : выполнение SQL-запроса DDL (CREATE, ALTER, DROP, COMMENT ON) в базе данных Hologres
gather_hg_table_statistics : Собрать статистику таблиц в базе данных Hologres
get_hg_query_plan : Получить план запроса в базе данных Hologres
get_hg_execution_plan : Получить план выполнения в базе данных Hologres
call_hg_procedure : Вызов процедуры в базе данных Hologres
create_hg_maxcompute_foreign_table : создание внешних таблиц MaxCompute в базе данных Hologres.

Поскольку некоторые агенты не поддерживают ресурсы и шаблоны ресурсов, для получения метаданных схем, таблиц, представлений и внешних таблиц предусмотрены следующие инструменты.

list_hg_schemas : выводит список всех схем в текущей базе данных Hologres, за исключением системных схем.
list_hg_tables_in_a_schema : выводит список всех таблиц в определенной схеме, включая их типы (таблица, представление, внешняя таблица, секционированная таблица).
show_hg_table_ddl : Показать сценарий DDL таблицы, представления или внешней таблицы в базе данных Hologres.

Ресурсы

Встроенные ресурсы

hologres:///schemas : Получить все схемы в базе данных Hologres

Шаблоны ресурсов

hologres:///{schema}/tables : Список всех таблиц в схеме в базе данных Hologres
hologres:///{schema}/{table}/partitions : Список всех разделов секционированной таблицы в базе данных Hologres
hologres:///{schema}/{table}/ddl : Получить таблицу DDL в базе данных Hologres
hologres:///{schema}/{table}/statistic : Показать собранную статистику таблиц в базе данных Hologres
system:///{+system_path} : Системные пути включают:
- hg_instance_version — показывает версию экземпляра hologres.
- guc_value/<guc_name> — показывает значение guc (Grand Unified Configuration).
- missing_stats_tables — показывает таблицы, в которых отсутствует статистика.
- stat_activity — показывает информацию о текущих запущенных запросах.
- query_log/latest/<row_limits> — Получить недавнюю историю журнала запросов с указанным количеством строк.
- query_log/user/<user_name>/<row_limits> — Получить историю журнала запросов для определенного пользователя с ограничениями по количеству строк.
- query_log/application/<application_name>/<row_limits> — получение истории журнала запросов для определенного приложения с ограничениями по количеству строк.
- query_log/failed/<interval>/<row_limits> — получение истории журнала неудачных запросов с интервалом и указанным количеством строк.