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

In diesem Dokument wird beschrieben, wie Sie Ihre AlloyDB-Instanz mit verschiedenen Agents 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. Sie müssen also keine separate Servereinrichtung vornehmen. 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

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`
Administratoraufgaben 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 Ihr Projekt und Ihre Datenbank einrichten.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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.

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 die zugehörige primäre Instanz aus.
Konfigurieren Sie Standardanmeldedaten für Anwendungen (ADC) für Ihre Umgebung.
Erstellen Sie einen Datenbanknutzer oder verwenden Sie einen vorhandenen. 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 in die Gemini CLI erfolgt über spezielle Erweiterungen, die im Vergleich zu einer Standardverbindung über die MCP Toolbox 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 Datenbankstatus.

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 in der Datenbank ausgeführt?
	`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_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 das IAM-Hauptkonto 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 zum Verwalten und Überwachen 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`	Zeige 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-Befehlszeile

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.

Mit Antigravity verbinden

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 Store.

Ö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.
Folge der Anleitung auf dem Bildschirm, um deine 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"-Property 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. Die 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 die 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 für Datenbanken 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:

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": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--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 Objekt env die folgende Zeile hinzu: "ALLOYDB_POSTGRES_IP_TYPE": "private"

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": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--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 folgende Zeile hinzu: "ALLOYDB_POSTGRES_IP_TYPE": "private"

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

Cline

Öffnen Sie die Cline-Erweiterung in VS Code und tippen 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": {
    "alloydb": {
     "command": "./PATH/TO/toolbox",
      "args": ["--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"
      }
    }
  }
}

Nachdem der Server erfolgreich verbunden wurde, wird ein grüner aktiver Status angezeigt.

Hinweis:Wenn Sie eine Verbindung über eine private IP-Adresse herstellen möchten, fügen Sie dem env-Objekt die folgende Zeile hinzu: "ALLOYDB_POSTGRES_IP_TYPE": "private"

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": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--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 folgende Zeile hinzu: "ALLOYDB_POSTGRES_IP_TYPE": "private"

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

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": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--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 Objekt env die folgende Zeile hinzu: "ALLOYDB_POSTGRES_IP_TYPE": "private"

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": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--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 Objekt env die folgende Zeile hinzu: "ALLOYDB_POSTGRES_IP_TYPE": "private"

AlloyDB for PostgreSQL mit MCP, Gemini CLI und anderen Agents verwenden Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweise

Gemini CLI-Erweiterungen für AlloyDB verwenden

AlloyDB-Erweiterung

AlloyDB-Erweiterung für Beobachtbarkeit

Gemini-Befehlszeile

Gemini Code Assist

Mit Antigravity verbinden

MCP Store

Benutzerdefinierte Konfiguration

Mit anderen IDEs über die MCP Toolbox for Databases verbinden

MCP Toolbox für Datenbanken installieren

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Client konfigurieren

Claude-Code

Claude für den Computer

Cline

Cursor

Visual Studio Code (Copilot)

Windsurf

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