AlloyDB Omni mit MCP, Gemini CLI und anderen Agents verwenden

Wählen Sie eine Dokumentationsversion aus:

In diesem Dokument wird beschrieben, wie Sie Ihre AlloyDB Omni-Instanz mit verschiedenen Agenten verbinden, die das Model Context Protocol (MCP) unterstützen.

Da AlloyDB Omni mit PostgreSQL kompatibel ist, können Sie Tools und Erweiterungen verwenden, die für PostgreSQL entwickelt wurden.

Die einfachste Einrichtung bietet die dedizierte PostgreSQL-Erweiterung für die Gemini CLI. Sie integriert den zugrunde liegenden MCP-Server direkt in die Erweiterung, sodass Sie keinen separaten Server einrichten müssen. Sie können Gemini Code Assist so konfigurieren, dass die Gemini CLI verwendet wird. Das bietet ähnliche Vorteile bei der Einrichtung in Ihrer IDE.

Alternativ können andere IDEs und Agenten, die das MCP unterstützen, über die MCP Toolbox for Databases verbunden werden. Toolbox ist ein Open-Source-MCP-Server, der KI-Agenten mit Ihren Daten verbindet. Er übernimmt Aufgaben wie die Authentifizierung und das Verbindungs-Pooling, sodass Sie direkt in Ihrer IDE in natürlicher Sprache mit Ihren Daten interagieren können.

Hinweis

Bevor Sie eine Verbindung zu Ihrer AlloyDB Omni-Instanz herstellen, müssen Sie Folgendes tun:

  1. AlloyDB Omni für Container installiert und eine laufende Datenbankinstanz haben.
  2. Erstellen Sie einen Datenbanknutzer oder verwenden Sie einen vorhandenen. Halten Sie den Nutzernamen und das Passwort bereit.

Gemini CLI-Erweiterung für PostgreSQL verwenden

Die Gemini CLI ist ein Open-Source-KI-Agent, der Sie bei Entwicklungs-Workflows unterstützt, z. B. beim Programmieren, Debuggen, bei der Datenexploration und beim Erstellen von Inhalten. Ziel ist es, eine agentische Schnittstelle für die Interaktion mit Data Cloud-Diensten und gängigen Open-Source-Datenbanken bereitzustellen.

Die Einbindung in die Gemini-Befehlszeile für AlloyDB Omni erfolgt über die PostgreSQL-Erweiterung. Diese Erweiterung bietet eine Reihe von Tools für die Interaktion mit PostgreSQL und AlloyDB Omni, mit denen Sie Ihre Datenbanken verwalten, Abfragen ausführen und Schemas direkt über die Gemini CLI mit Prompts in natürlicher Sprache untersuchen können.

In den folgenden Beispielen wird eine ecommerce-Beispieldatenbank mit den folgenden Tabellen verwendet:

  • products: enthält Produktinformationen, einschließlich product_id, product_name, category und price.
  • customers: Speichert Kundendaten wie customer_id, first_name, last_name und email.
  • orders: enthält Bestellinformationen, einschließlich order_id, customer_id und order_date.

Die folgenden Tools sind in der PostgreSQL-Erweiterung verfügbar:

Kategorie Tool Beispiel für einen Prompt in natürlicher Sprache
Datenbankvorgänge execute_sql Zeige mir die 10 teuersten Produkte in der Kategorie „Laptops“.
get_query_plan Explain the query plan for a query that finds all customers who have not placed an order in the last 6 months.
list_active_queries Welche Abfragen werden in der Datenbank ausgeführt?
database_overview Gib mir einen Überblick über die aktuelle Datenbank.
list_tables Zeige mir alle Tabellen in der aktuellen Datenbank.
list_views Welche Ansichten sind verfügbar?
list_schemas Alle Schemas auflisten
list_triggers Zeig mir die Trigger in der Tabelle „orders“.
list_available_extensions Welche Erweiterungen kann ich installieren?
list_installed_extensions Alle installierten Erweiterungen auflisten.
list_indexes Alle Indexe auflisten
list_sequences Alle Sequenzen auflisten.
Datenbankstatus und -wartung list_autovacuum_configurations Zeige mir die aktuelle Autovacuum-Konfiguration.
list_memory_configurations Wie sind die aktuellen Speicherkonfigurationen?
list_top_bloated_tables Listen Sie die fünf am stärksten aufgeblähten Tabellen auf.
list_replication_slots Alle aktiven Replikations-Slots anzeigen.
list_invalid_indexes Prüfen Sie, ob in der Datenbank ecommerce ungültige Indexe vorhanden sind.
long_running_transactions Zeig mir die Transaktionen mit langer Ausführungszeit.
list_locks Alle Sperren auflisten.
replication_stats Zeigen Sie mir die Replikationsstatistiken.

Sie können die Gemini CLI-Erweiterung für PostgreSQL auf zwei Arten verwenden:

  • Ein eigenständiges Befehlszeilentool
  • Mit Gemini Code Assist in Ihre IDE eingebunden

Gemini CLI

  1. Installieren Sie die Gemini CLI (Version 0.6.0 oder höher).
  2. Installieren Sie die PostgreSQL-Erweiterung für die Gemini CLI aus dem GitHub-Repository mit dem folgenden Befehl: 
    gemini extensions install https://github.com/gemini-cli-extensions/postgres
  3. Legen Sie Umgebungsvariablen fest, um eine Verbindung zu Ihrer AlloyDB Omni-Instanz herzustellen: 
    export POSTGRES_HOST="DATABASE_HOST"
export POSTGRES_PORT="DATABASE_PORT"
export POSTGRES_DATABASE="DATABASE_NAME"
export POSTGRES_USER="DATABASE_USER"
export POSTGRES_PASSWORD="DATABASE_PASSWORD"

    Sie können diese Variablen auch aus einer .env-Datei in Ihrem Arbeitsverzeichnis laden.

  4. Starten Sie die Gemini CLI im interaktiven Modus: 
    gemini
     Die Befehlszeile lädt automatisch die PostgreSQL-Erweiterung und die zugehörigen Tools, mit denen Sie mit Ihrer Datenbank interagieren können.

Gemini Code Assist

Wenn Sie einen MCP-Server nicht manuell konfigurieren möchten, können Sie Gemini Code Assist so konfigurieren, dass die Gemini CLI verwendet wird.

  1. Installieren und konfigurieren Sie die Gemini CLI und die postgres-Erweiterung wie auf dem Tab „Gemini CLI“ beschrieben.
  2. Gemini Code Assist für die Verwendung der Gemini CLI konfigurieren
  3. Sie können direkt im Gemini Code Assist-Chat in natürlicher Sprache mit Ihrer AlloyDB Omni-Instanz interagieren.

Mit anderen IDEs über die MCP Toolbox for Databases verbinden

In diesem Abschnitt wird beschrieben, wie Sie mit der MCP Toolbox for Databases von verschiedenen Agenten aus eine Verbindung zu Ihrer AlloyDB Omni-Instanz herstellen.

MCP Toolbox for Databases installieren

Wenn Sie Ihre IDE mit AlloyDB Omni verbinden möchten, müssen Sie die MCP Toolbox for Databases installieren. Das ist ein Open-Source-Server, der KI-Agenten mit Ihren Daten verbindet.

  1. Laden Sie die aktuelle Version der Toolbox als Binärprogramm herunter. Wählen Sie das Binärprogramm aus, das Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht.

    linux/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/linux/amd64/toolbox

    darwin/arm64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/darwin/arm64/toolbox

    darwin/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/darwin/amd64/toolbox

    windows/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/windows/amd64/toolbox.exe

  2. Machen Sie das Binärprogramm ausführbar.

    chmod +x toolbox

  3. Prüfen Sie die Installation.

    ./toolbox --version

Client konfigurieren

Wählen Sie Ihr Agententool aus den folgenden Optionen aus:

Cursor

  1. Erstellen Sie das Verzeichnis .cursor im Stammverzeichnis Ihres Projekts, falls es noch nicht vorhanden ist.
  2. Erstellen Sie die Datei .cursor/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Öffnen Sie Cursor und rufen Sie Einstellungen > Cursor-Einstellungen > MCP auf. Wenn der Server eine Verbindung herstellt, wird ein grüner Aktivitätsstatus angezeigt.

Windsurf

  1. Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
  2. Klicken Sie auf das MCP-Symbol und dann auf Konfigurieren, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}

Visual Studio Code (Copilot)

  1. Öffnen Sie VS Code und erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis .vscode, falls es noch nicht vorhanden ist.
  2. Erstellen Sie die Datei .vscode/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "servers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}

Cline

  1. Öffnen Sie die Cline-Erweiterung in VS Code und klicken Sie auf das Symbol MCP-Server.
  2. Klicken Sie auf MCP-Server konfigurieren, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Nachdem der Server erfolgreich verbunden wurde, wird der Status „Aktiv“ in Grün angezeigt.

Claude für den Computer

  1. Öffnen Sie Claude für Desktop und rufen Sie die Einstellungen auf.
  2. Klicken Sie auf dem Tab Entwickler auf Konfiguration bearbeiten, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie die Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Starten Sie Claude für Desktop neu.
  2. Auf dem neuen Chatbildschirm wird ein Hammersymbol (MCP) mit dem neuen MCP-Server angezeigt.

Claude-Code

  1. Installieren Sie Claude Code.
  2. Erstellen Sie im Stammverzeichnis Ihres Projekts eine .mcp.json-Datei, falls sie noch nicht vorhanden ist.
  3. Fügen Sie die Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Starten Sie Claude Code neu, um die neue Konfiguration anzuwenden.