Englisch |中文

Hologres MCP-Server

Der Hologres MCP Server dient als universelle Schnittstelle zwischen KI-Agenten und Hologres-Datenbanken. Er ermöglicht die nahtlose Kommunikation zwischen KI-Agenten und Hologres und unterstützt KI-Agenten beim Abrufen von Metadaten aus Hologres-Datenbanken sowie bei der Ausführung von SQL-Operationen.

Konfiguration

Modus 1: Lokale Datei verwenden

Herunterladen

Von Github herunterladen

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

MCP-Integration

Fügen Sie der MCP-Client-Konfigurationsdatei die folgende Konfiguration hinzu:

{
    "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"
            }
        }
    }
}

Modus 2: Verwenden des PIP-Modus

Installation

Installieren Sie MCP Server mit dem folgenden Paket:

pip install hologres-mcp-server

MCP-Integration

Fügen Sie der MCP-Client-Konfigurationsdatei die folgende Konfiguration hinzu:

Verwenden Sie den UV-Modus

{
    "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"
            }
        }
    }
}

Verwenden Sie den UVX-Modus

{
    "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

Komponenten

Werkzeuge

execute_hg_select_sql : Führen Sie eine SELECT-SQL-Abfrage in der Hologres-Datenbank aus
execute_hg_select_sql_with_serverless : Führen Sie eine SELECT-SQL-Abfrage in der Hologres-Datenbank mit serverlosem Computing aus
execute_hg_dml_sql : Führen Sie eine DML-SQL-Abfrage (INSERT, UPDATE, DELETE) in der Hologres-Datenbank aus
execute_hg_ddl_sql : Führen Sie eine DDL-SQL-Abfrage (CREATE, ALTER, DROP, COMMENT ON) in der Hologres-Datenbank aus
gather_hg_table_statistics : Sammeln Sie Tabellenstatistiken in der Hologres-Datenbank
get_hg_query_plan : Abfrageplan in der Hologres-Datenbank abrufen
get_hg_execution_plan : Ausführungsplan in der Hologres-Datenbank abrufen
call_hg_procedure : Ruft eine Prozedur in der Hologres-Datenbank auf
create_hg_maxcompute_foreign_table : Erstellen Sie MaxCompute-Fremdtabellen in der Hologres-Datenbank.

Da einige Agenten keine Ressourcen und Ressourcenvorlagen unterstützen, werden die folgenden Tools bereitgestellt, um die Metadaten von Schemas, Tabellen, Ansichten und externen Tabellen abzurufen.

list_hg_schemas : Listet alle Schemas in der aktuellen Hologres-Datenbank auf, ausgenommen Systemschemas.
list_hg_tables_in_a_schema : Listet alle Tabellen in einem bestimmten Schema auf, einschließlich ihrer Typen (Tabelle, Ansicht, externe Tabelle, partitionierte Tabelle).
show_hg_table_ddl : Zeigt das DDL-Skript einer Tabelle, Ansicht oder externen Tabelle in der Hologres-Datenbank an.

Ressourcen

Integrierte Ressourcen

hologres:///schemas : Alle Schemata in der Hologres-Datenbank abrufen

Ressourcenvorlagen

hologres:///{schema}/tables : Listet alle Tabellen in einem Schema in der Hologres-Datenbank auf
hologres:///{schema}/{table}/partitions : Listet alle Partitionen einer partitionierten Tabelle in der Hologres-Datenbank auf
hologres:///{schema}/{table}/ddl : Tabellen-DDL in der Hologres-Datenbank abrufen
hologres:///{schema}/{table}/statistic : Zeigt gesammelte Tabellenstatistiken in der Hologres-Datenbank an
system:///{+system_path} : Zu den Systempfaden gehören:
- hg_instance_version – Zeigt die Version der Hologres-Instanz an.
- guc_value/<guc_name> – Zeigt den guc-Wert (Grand Unified Configuration) an.
- missing_stats_tables – Zeigt die Tabellen an, für die Statistiken fehlen.
- stat_activity – Zeigt die Informationen zu aktuell ausgeführten Abfragen.
- query_log/latest/<row_limits> – Ruft den aktuellen Abfrageprotokollverlauf mit der angegebenen Zeilenanzahl ab.
- query_log/user/<user_name>/<row_limits> – Rufen Sie den Abfrageprotokollverlauf für einen bestimmten Benutzer mit Zeilenlimits ab.
- query_log/application/<application_name>/<row_limits> – Rufen Sie den Abfrageprotokollverlauf für eine bestimmte Anwendung mit Zeilenlimits ab.
- query_log/failed/<interval>/<row_limits> – Ruft den Protokollverlauf fehlgeschlagener Abfragen mit Intervall und angegebener Zeilenanzahl ab.