Auf dieser Seite wird die AlloyDB Omni-Version 16.9.0 mit der Bereitstellungsoption Kubernetes dokumentiert. Wählen Sie eine andere Bereitstellungsoption aus.

Diese Seite wurde von der Cloud Translation API übersetzt.

AlloyDB Omni mit MCP, Gemini CLI und anderen Agents verwenden

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.

Für die einfachste Einrichtung verwenden Sie die dedizierte PostgreSQL-Erweiterung für die Gemini CLI. Sie integriert den zugrunde liegenden MCP-Server direkt in die Erweiterung, sodass Sie keine separate Servereinrichtung vornehmen müssen. Sie können Gemini Code Assist so konfigurieren, dass die Gemini CLI verwendet wird. Das bietet ähnliche Einrichtungsvorteile in Ihrer IDE.

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

Hinweise

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

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

Gemini CLI-Erweiterung für PostgreSQL verwenden

Gemini CLI ist ein Open-Source-KI-Agent, der Sie bei Entwicklungs-Workflows unterstützt, indem er Ihnen beim Programmieren, Debuggen, bei der Datenanalyse und beim Erstellen von Inhalten hilft. Ziel ist es, eine Schnittstelle für die Interaktion mit Data Cloud-Diensten und beliebten Open-Source-Datenbanken bereitzustellen.

Die Integration in die Gemini CLI 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. Damit können Sie Ihre Datenbanken verwalten, Abfragen ausführen und Schemas direkt über die Gemini CLI mit Prompts in natürlicher Sprache untersuchen.

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

products: enthält Produktinformationen, darunter product_id, product_name, category und price.
customers: Hier werden Kundendaten wie customer_id, first_name, last_name und email gespeichert.
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`	Erläutern Sie den Abfrageplan für eine Abfrage, mit der alle Kunden ermittelt werden, die in den letzten sechs Monaten keine Bestellung aufgegeben haben.
	`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`	Zeige mir die Auslöser in der Tabelle mit den Bestellungen.
	`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`	Welche Speicherkonfigurationen sind derzeit verfügbar?
	`list_top_bloated_tables`	Liste die fünf Tabellen mit den meisten Daten auf.
	`list_replication_slots`	Alle aktiven Replikations-Slots anzeigen.
	`list_invalid_indexes`	Prüfen Sie, ob in der `ecommerce`-Datenbank ungültige Indexe vorhanden sind.
	`long_running_transactions`	Zeige mir die lang andauernden Transaktionen.
	`list_locks`	Alle Schlösser auflisten.
	`replication_stats`	Zeig mir die Replikationsstatistiken.

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

Eigenständiges Befehlszeilentool
In Ihre IDE mit Gemini Code Assist integriert

Gemini-Befehlszeile

Installieren Sie die Gemini-Befehlszeile (Version 0.6.0 oder höher).
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
```

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.

Starten Sie die Gemini CLI im interaktiven Modus:
```
gemini
```
Die CLI 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, konfigurieren Sie Gemini Code Assist so, dass die Gemini CLI verwendet wird.

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

Mit anderen IDEs über die MCP Toolbox for Databases verbinden

In diesem Abschnitt wird beschrieben, wie Sie mit der MCP Toolbox for Databases eine Verbindung zu Ihrer AlloyDB Omni-Instanz über verschiedene Agents herstellen.

MCP Toolbox für Datenbanken 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-Agents mit Ihren Daten verbindet.

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

Machen Sie das Binärprogramm ausführbar.
```
chmod +x toolbox
```
Prüfen Sie die Installation.
```
./toolbox --version
```

Client konfigurieren

Wählen Sie das gewünschte Agent-Tool aus den folgenden Optionen aus:

Cursor

Erstellen Sie das Verzeichnis .cursor im Stammverzeichnis Ihres Projekts, falls es noch nicht vorhanden ist.
Erstellen Sie die Datei .cursor/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
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"
      }
    }
  }
}

Öffnen Sie Cursor und gehen Sie zu Einstellungen > Cursoreinstellungen > MCP. Wenn der Server verbunden ist, wird ein grüner aktiver Status angezeigt.

Windsurf

Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
Klicken Sie auf das MCP-Symbol und dann auf Konfigurieren, um die Konfigurationsdatei zu öffnen.
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)

Öffnen Sie VS Code und erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis .vscode, falls es noch nicht vorhanden ist.
Erstellen Sie die Datei .vscode/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
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

Öffnen Sie die Cline-Erweiterung in VS Code und klicken Sie auf das Symbol MCP-Server.
Klicken Sie auf MCP-Server konfigurieren, um die Konfigurationsdatei zu öffnen.
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"
      }
    }
  }
}

Nach erfolgreicher Verbindung des Servers wird ein grüner aktiver Status angezeigt.

Claude für den Computer

Öffnen Sie Claude für Desktop und rufen Sie die Einstellungen auf.
Klicken Sie auf dem Tab Entwickler auf Konfiguration bearbeiten, um die Konfigurationsdatei zu öffnen.
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"
      }
    }
  }
}

Starten Sie Claude für den Computer neu.
Auf dem neuen Chatbildschirm wird ein Hammersymbol (MCP) mit dem neuen MCP-Server angezeigt.

Claude-Code

Installieren Sie Claude Code.
Erstellen Sie im Stammverzeichnis Ihres Projekts die Datei .mcp.json, falls sie noch nicht vorhanden ist.
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"
      }
    }
  }
}

Starten Sie Claude-Code neu, um die neue Konfiguration anzuwenden.