Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

AlloyDB for PostgreSQL mit MCP, Gemini CLI und anderen Agents verwenden

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

Wir empfehlen, die dedizierte AlloyDB-Erweiterung für die Gemini CLI zu verwenden. Bei der Gemini CLI ist der zugrunde liegende MCP-Server direkt in die Erweiterung integriert, 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 verbunden werden. Toolbox ist ein Open-Source-MCP-Server, der KI-Agenten mit Ihren Daten verbindet. Sie ü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.

Hinweis

Um eine Verbindung zu Ihrer AlloyDB-Instanz herzustellen und die verfügbaren Tools zu verwenden, benötigen Sie eine der folgenden IAM-Rollen (Identity and Access Management) oder eine benutzerdefinierte Rolle mit entsprechenden Berechtigungen:

Aufgabe	Rollenname	Erforderliche IAM-Rolle (Identity and Access Management)
Schreibgeschützte Tools zum Auflisten und Abrufen von AlloyDB-Ressourcen verwenden	AlloyDB Viewer	`roles/alloydb.viewer`
Verbindung zu einer Instanz herstellen und Abfragen ausführen	Cloud AlloyDB-Client	`roles/alloydb.client`
	Service Usage Consumer	`roles/serviceusage.serviceUsageConsumer`
Administrative Aufgaben ausführen, z. B. Cluster, Instanzen und Nutzer erstellen oder verwalten	AlloyDB Admin	`roles/alloydb.admin`
Observability-Erweiterung verwenden	Monitoring-Betrachter	`roles/monitoring.viewer`

Bevor Sie eine Verbindung zu Ihrer AlloyDB-Instanz herstellen können, müssen Sie die folgenden Schritte ausführen, um Ihr Projekt und Ihre Datenbank einzurichten.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Google Cloud project.
Aktivieren Sie die Cloud APIs, die zum Erstellen einer Verbindung zu AlloyDB erforderlich sind.

APIs aktivieren
1. Klicken Sie im Schritt Projekt bestätigen auf Weiter, um den Namen des Projekts zu bestätigen, an dem Sie Änderungen vornehmen möchten.
2. Klicken Sie im Schritt APIs aktivieren auf Aktivieren, um Folgendes zu aktivieren:
  - AlloyDB API
  - Compute Engine API
  - Cloud Resource Manager API
  - Service Networking API
  Die Service Networking API ist erforderlich, wenn Sie die Netzwerkkonnektivität zu AlloyDB über ein VPC-Netzwerk konfigurieren möchten, das sich im selben Google Cloud Projekt wie AlloyDB befindet.
  
  Die Compute Engine API und die Cloud Resource Manager API sind erforderlich, wenn Sie die Netzwerkverbindung zu AlloyDB über ein VPC-Netzwerk konfigurieren möchten, das sich in einem anderen Google Cloud -Projekt befindet.
Erstellen oder wählen Sie einen Cluster und seine primäre Instanz aus.
Konfigurieren Sie Standardanmeldedaten für Anwendungen (ADC) für Ihre Umgebung.
Erstellen oder verwenden Sie einen Datenbanknutzer. Halten Sie den Nutzernamen und das Passwort bereit.

Gemini CLI-Erweiterungen für AlloyDB verwenden

Die Gemini CLI ist ein Open-Source-KI-Agent, der Sie bei Entwicklungs-Workflows unterstützt, indem er Ihnen beim Programmieren, Debuggen, bei der Datenexploration 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 mit der Gemini CLI erfolgt über spezielle Erweiterungen, die im Vergleich zu einer standardmäßigen MCP-Toolbox-Verbindung zusätzliche Funktionen bieten. In den folgenden Abschnitten werden die Erweiterungen alloydb und alloydb-observability beschrieben, die einen Installationsprozess und eine Reihe von Tools bieten. Die Open-Source-Erweiterungen enthalten detaillierte Informationen zur Installation, Konfiguration und Anwendungsbeispiele. Weitere Informationen finden Sie unter Gemini CLI-Erweiterung – AlloyDB for PostgreSQL.

AlloyDB-Erweiterung

Die alloydb-Erweiterung enthält Tools zum Abfragen der Datenbank, zum Verwalten von AlloyDB-Ressourcen und zum Überwachen des Datenbankzustands.

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: Speichert Kundendaten wie customer_id, first_name, last_name und email.
orders: Enthält Bestellinformationen, einschließlich order_id, customer_id und order_date.

Kategorie	Tools	Beispiel für einen Prompt in natürlicher Sprache
Datenbankvorgänge	`database_overview`	Gib mir einen Überblick über die aktuelle Datenbank.
	`list_tables`	Zeige mir alle Tabellen in der aktuellen Datenbank.
	`execute_sql`	Zeige mir die 10 teuersten Produkte in der Kategorie „Laptops“.
	`list_active_queries`	Welche Abfragen werden für die Datenbank ausgeführt?
	`get_query_plan`	Erläutere den Abfrageplan für eine Abfrage, mit der alle Kunden ermittelt werden, die in den letzten sechs Monaten keine Bestellung aufgegeben haben.
	`list_available_extensions`	Welche Erweiterungen kann ich installieren?
	`list_installed_extensions`	Alle installierten Erweiterungen auflisten
	`list_indexes`	Alle Indexe in der Tabelle `products` auflisten.
	`list_locks`	Alle aktiven Sperren für die Datenbank anzeigen.
	`list_schemas`	Alle Schemas in der Datenbank auflisten
	`list_sequences`	Alle Sequenzen im aktuellen Schema anzeigen.
	`list_triggers`	Listen Sie alle Trigger für die Tabelle `orders` auf.
	`list_views`	Zeige mir alle Ansichten im Schema `sales`.
Ressourcenverwaltung Cluster, Instanzen, Nutzer	`create_cluster`	Erstellen Sie einen AlloyDB-Cluster mit dem Namen `sales-quarterly-db` in der Region `us-east1`.
	`get_cluster`	Rufen Sie die Details für den Cluster `sales-quarterly-db` ab.
	`list_clusters`	Liste alle meine AlloyDB-Cluster auf.
	`create_instance`	Erstellen Sie eine neue Leseinstanz im Cluster `sales-quarterly-db`.
	`get_instance`	Zeige mir die Informationen für die Instanz `sales-quarterly-db-rp`.
	`list_instances`	Alle Instanzen im Cluster `sales-quarterly-db` auflisten
	`create_user`	Hinweis:Mit dem Tool `create_user` können zwei Arten von Datenbanknutzern erstellt werden: Datenbanknutzer mit integrierter Authentifizierung: Diese Nutzer werden in der Datenbank verwaltet und authentifizieren sich mit einem Passwort. IAM-Nutzer: Diese Nutzer werden in IAM verwaltet und authentifizieren sich mit ihren IAM-Anmeldedaten. Wenn Sie einen Datenbanknutzer mit integrierter Authentifizierung erstellen, müssen Sie ein Passwort angeben. Wenn Sie einen IAM-Nutzer erstellen, müssen Sie den IAM-Prinzipal angeben. Erstellen Sie einen neuen Datenbanknutzer mit dem Namen `reporting_user` und dem Passwort `report_password`. Erstellen Sie einen neuen IAM-Datenbanknutzer für `reporting_user@example.com`.
	`get_user`	Rufen Sie die Informationen für den Nutzer `reporting_user` ab.
	`list_users`	Alle Datenbanknutzer auflisten
	`wait_for_operation`	Welchen Status hat der Vorgang `operation-163562789`?
Datenbankstatus und ‑wartung	`list_autovacuum_configurations`	Zeige mir die aktuelle Autovacuum-Konfiguration.
	`list_memory_configurations`	Welche Speicherkonfigurationen gibt es derzeit für die primäre Instanz?
	`list_top_bloated_tables`	Liste die fünf Tabellen mit den meisten Daten auf.
	`list_replication_slots`	Alle aktiven Replikations-Slots anzeigen.
	`replication_stats`	Aktuelle Replikationsstatistiken anzeigen
	`list_invalid_indexes`	Prüfen Sie, ob in der `ecommerce`-Datenbank ungültige Indexe vorhanden sind.
	`long_running_transactions`	Gibt es lang andauernde Transaktionen?

AlloyDB-Erweiterung für Beobachtbarkeit

Die alloydb-observability-Erweiterung bietet eine einheitliche Oberfläche für die Verwaltung und Überwachung der Datenbankleistung und des Datenbankzustands direkt über die Gemini-Befehlszeile.

Kategorie	Tools	Beispiel für einen Prompt in natürlicher Sprache
Beobachtbarkeit	`get_system_metrics`	Wie lauten die Systemmesswerte, z. B. die CPU-Auslastung, für die letzte Stunde?
Beobachtbarkeit	`get_query_metrics`	Zeig mir die Messwerte zur Abfrageleistung der letzten 15 Minuten.

Sie haben zwei Möglichkeiten, die Gemini CLI-Erweiterung für AlloyDB zu verwenden:

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

Gemini CLI

Installieren Sie die Gemini-Befehlszeile.
Installieren Sie die AlloyDB-Erweiterung für die Gemini CLI aus dem GitHub-Repository mit dem folgenden Befehl:
```
gemini extensions install https://github.com/gemini-cli-extensions/alloydb
```
Legen Sie Umgebungsvariablen fest, um eine Verbindung zu Ihrer AlloyDB-Instanz herzustellen:
```
export ALLOYDB_POSTGRES_PROJECT="PROJECT_ID"
export ALLOYDB_POSTGRES_REGION="REGION"
export ALLOYDB_POSTGRES_CLUSTER="CLUSTER_NAME"
export ALLOYDB_POSTGRES_INSTANCE="INSTANCE_NAME"
export ALLOYDB_POSTGRES_DATABASE="DATABASE_NAME"
```
Die Gemini CLI-Erweiterung für AlloyDB verwendet standardmäßig Ihre [Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC)](/authentication/application-default-credentials) für die Authentifizierung. Wenn Sie stattdessen als Datenbanknutzer eine Verbindung herstellen möchten, legen Sie die folgenden optionalen Umgebungsvariablen fest:
```
#Optional: Set for database user authentication
export ALLOYDB_POSTGRES_USER="USERNAME"
export ALLOYDB_POSTGRES_PASSWORD="PASSWORD"
```
Wenn Sie eine Verbindung über eine private IP-Adresse herstellen möchten, müssen Sie auch die folgende Umgebungsvariable festlegen:
```
export ALLOYDB_POSTGRES_IP_TYPE="private"
```
Starten Sie die Gemini CLI im interaktiven Modus:
```
gemini
```
Die CLI lädt automatisch die AlloyDB-Erweiterung für die Gemini CLI-Erweiterung und ihre Tools, mit denen Sie mit Ihrer Datenbank interagieren können.

Gemini Code Assist

Wir empfehlen, Gemini Code Assist für die Verwendung der Gemini CLI zu konfigurieren. So ist es nicht erforderlich, einen MCP-Server manuell zu konfigurieren.

Prüfen Sie, ob die Gemini CLI und die alloydb-Erweiterung installiert und konfiguriert sind.
Gemini Code Assist für die Verwendung der Gemini CLI konfigurieren
Beginnen Sie mit der Interaktion mit Ihrer AlloyDB-Instanz, indem Sie direkt im Gemini Code Assist-Chat Prompts in natürlicher Sprache eingeben.

Verbindung mit Antigravity

Sie haben folgende Möglichkeiten, AlloyDB mit Antigravity zu verbinden:

MCP Store verwenden
Benutzerdefinierte Konfiguration verwenden

Hinweis:Sie müssen das MCP Toolbox-Binärprogramm nicht herunterladen, um diese Methoden zu verwenden.

MCP Store

Die empfohlene Methode zum Herstellen einer Verbindung zu AlloyDB in Antigravity ist die Verwendung des integrierten MCP-Stores.

Öffnen Sie Antigravity und dann den Agent-Bereich des Editors.
Klicken Sie oben im Bereich auf das Symbol „…“ und wählen Sie MCP-Server aus.
Suchen Sie in der Liste der verfügbaren Server nach AlloyDB for PostgreSQL und klicken Sie auf Installieren.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihre Konten sicher zu verknüpfen (falls zutreffend).

Nachdem Sie AlloyDB im MCP Store installiert haben, sind Ressourcen und Tools vom Server automatisch im Editor verfügbar.

Benutzerdefinierte Konfiguration

So stellen Sie eine Verbindung zu einem benutzerdefinierten MCP-Server her:

Öffnen Sie Antigravity und dann den Agent-Bereich des Editors.
Klicken Sie oben im Bereich auf das Symbol „…“ und wählen Sie MCP-Server aus.
Klicken Sie auf MCP-Server verwalten > Rohkonfiguration ansehen, um die mcp_config.json-Datei zu öffnen.
Fügen Sie der Datei mcp_config.json die folgende Konfiguration hinzu und speichern Sie sie.

{
  "mcpServers": {
    "alloydb-postgres": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Hinweis:Wenn Sie eine Verbindung über eine private IP-Adresse herstellen möchten, fügen Sie dem env-Objekt die "ALLOYDB_POSTGRES_IP_TYPE": "private"-Eigenschaft hinzu. Achten Sie darauf, der vorherigen Zeile ein Komma hinzuzufügen, damit das JSON-Format gültig bleibt.

Ersetzen Sie Folgendes:

PROJECT_ID: Projekt-ID in Google Cloud .
REGION: Der Name Ihrer AlloyDB-Region.
CLUSTER_NAME: Der Name Ihres AlloyDB-Clusters.
INSTANCE_NAME: Der Name Ihrer AlloyDB-Instanz.
DATABASE_NAME: Der Name Ihrer AlloyDB-Datenbank.
USERNAME: Ihr AlloyDB-Nutzername für die Variable ALLOYDB_POSTGRES_USER.
PASSWORD: Ihr AlloyDB-Passwort für die Variable ALLOYDB_POSTGRES_PASSWORD.

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-Instanz über verschiedene Agents herstellen. Toolbox fungiert als Open-Source-Model Context Protocol (MCP)-Server, der sich zwischen Ihrer IDE und Ihrer Datenbank befindet und eine Steuerungsebene für Ihre KI-Tools bietet. In diesem Abschnitt finden Sie eine Anleitung zum Herstellen einer Verbindung zu einer AlloyDB-Instanz über eine öffentliche oder private IP-Adresse. Standardmäßig verwendet Toolbox eine öffentliche IP-Adresse. Sie können jedoch eine private IP-Verbindung konfigurieren, indem Sie die Umgebungsvariable ALLOYDB_POSTGRES_IP_TYPE festlegen, wie in den Konfigurationsbeispielen gezeigt.

MCP Toolbox for Databases installieren

Wenn Sie Ihre IDE mit AlloyDB 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. Sie müssen die Toolbox-Version v0.15.0 oder höher verwenden.

linux/amd64

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

darwin/arm64

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

darwin/amd64

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

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.15.0/windows/amd64/toolbox

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: