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

Сервер 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> — получение истории журнала неудачных запросов с интервалом и указанным количеством строк.