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

Wenn Sie Ihre AlloyDB for PostgreSQL-Datenbank abfragen, Schemas prüfen und Datenbankressourcen in natürlicher Sprache über Ihre IDE oder Ihr Terminal verwalten möchten, können Sie Ihre Instanz mit KI-Tools verbinden, die das Model Context Protocol (MCP) unterstützen.

Wir empfehlen die Verwendung der dedizierten AlloyDB-Erweiterung für die Gemini CLI. Die Gemini CLI 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 eine Verbindung herstellen. 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

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
Tools mit Lesezugriff zum Auflisten und Abrufen von AlloyDB-Ressourcen verwenden AlloyDB Viewer roles/alloydb.viewer
Verbindung zu einer Instanz herstellen und Abfragen ausführen 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
Beobachtbarkeitserweiterung 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.

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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

  3. Verify that billing is enabled for your Google Cloud project.

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

  5. Verify that billing is enabled for your Google Cloud project.

  6. Aktivieren Sie die Cloud APIs, die zum Erstellen von AlloyDB und zum Herstellen einer Verbindung 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 Netzwerkverbindung zu AlloyDB über ein VPC-Netzwerk (Virtual Private Cloud) 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.

  7. Cluster und primäre Instanz erstellen oder auswählen
  8. Konfigurieren Sie Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) für Ihre Umgebung.
  9. 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, z. B. beim Programmieren, Debuggen, bei der Datenexploration und beim Erstellen von Inhalten. Ziel ist es, eine interaktive Oberfläche für die Interaktion mit Data Cloud-Diensten und gängigen Open-Source-Datenbanken bereitzustellen.

Die Einbindung in die 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 Nutzung. Weitere Informationen finden Sie unter Gemini CLI-Erweiterung – AlloyDB for PostgreSQL.

AlloyDB-Erweiterung

Die Erweiterung alloydb 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, 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.
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äutere den Abfrageplan für eine Abfrage, die alle Kunden findet, die in den letzten 6 Monaten keine Bestellung aufgegeben haben.
list_available_extensions Welche Erweiterungen kann ich installieren?
list_installed_extensions Alle installierten Erweiterungen auflisten.
list_indexes Listen Sie alle Indexe in der Tabelle products auf.
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 Zeig 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 Alle meine AlloyDB-Cluster auflisten.
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 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 Wie ist der Status des Vorgangs operation-163562789?
Datenbankstatus und -wartung list_autovacuum_configurations Zeige mir die aktuelle Autovacuum-Konfiguration.
list_memory_configurations Wie sehen die aktuellen Arbeitsspeicherkonfigurationen für die primäre Instanz aus?
list_top_bloated_tables Listen Sie die fünf am stärksten aufgeblähten Tabellen auf.
list_replication_slots Alle aktiven Replikations-Slots anzeigen.
replication_stats Aktuelle Replikationsstatistiken anzeigen.
list_invalid_indexes Prüfen Sie, ob in der Datenbank ecommerce ungültige Indexe vorhanden sind.
long_running_transactions Gibt es lang andauernde Transaktionen?

AlloyDB Observability-Erweiterung

Die Erweiterung alloydb-observability bietet eine einheitliche Oberfläche, um die Leistung und den Zustand von Datenbanken direkt über die Gemini-CLI zu verwalten und zu überwachen.

Kategorie Tools Beispiel für einen Prompt in natürlicher Sprache
Beobachtbarkeit get_system_metrics Wie sehen die Systemmesswerte wie die CPU-Auslastung für die letzte Stunde aus?
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:

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

Gemini CLI

  1. Installieren Sie die Gemini-Befehlszeile.
  2. 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
  3. 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) zur Authentifizierung. Wenn Sie stattdessen eine Verbindung als Datenbanknutzer 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"
  4. Starten Sie die Gemini CLI im interaktiven Modus: 
    gemini
    Die CLI lädt automatisch die AlloyDB-Erweiterung für die Gemini CLI und die zugehörigen 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, da so kein MCP-Server manuell konfiguriert werden muss.

  1. Prüfen Sie, ob die Gemini CLI und die alloydb-Erweiterung installiert und konfiguriert sind.
  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-Instanz interagieren.

Mit Antigravity verbinden

Sie können AlloyDB auf folgende Arten mit Antigravity 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, um in Antigravity eine Verbindung zu AlloyDB herzustellen, ist die Verwendung des integrierten MCP Store.

  1. Öffnen Sie Antigravity und dann den Agentenbereich des Editors.
  2. Klicken Sie oben im Bereich auf das Dreipunkt-Menü … und wählen Sie MCP-Server aus.
  3. Suchen Sie in der Liste der verfügbaren Server nach AlloyDB for PostgreSQL und klicken Sie auf Installieren.
  4. Folgen Sie den Aufforderungen 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:

  1. Öffnen Sie Antigravity und dann den Agentenbereich des Editors.
  2. Klicken Sie oben im Bereich auf das Dreipunkt-Menü … und wählen Sie MCP-Server aus.
  3. Klicken Sie auf MCP-Server verwalten > Rohkonfiguration ansehen, um die Datei mcp_config.json zu öffnen.
  4. 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"
      }
    }
  }
}
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 von verschiedenen KI-Agenten aus eine Verbindung zu Ihrer AlloyDB-Instanz herstellen. Toolbox fungiert als Open-Source-MCP-Server (Model Context Protocol), der zwischen Ihrer IDE und Ihrer Datenbank liegt 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-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. 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

  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:

Claude-Code

  1. Installieren Sie Claude Code.
  2. Erstellen Sie im Stammverzeichnis Ihres Projekts die Datei .mcp.json, 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": {
    "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"
      }
    }
  }
}

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": {
    "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"
      }
    }
  }
}
  1. Starten Sie Claude für Desktop neu.
  2. Auf dem neuen Chatbildschirm wird ein Hammersymbol (MCP) mit dem neuen MCP-Server angezeigt.

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": {
    "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 Aktivitätsstatus angezeigt.

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

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

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

Mit der MCP Toolbox for Databases auf erweiterte Query Insights zugreifen

Mit der MCP Toolbox for Databases können Sie direkt in Ihrer IDE auf AlloyDB-Beobachtbarkeitsfunktionen und erweiterte Query Insights zugreifen. So können KI-Agenten Statistiken zur Abfrageausführung analysieren, Warteereignisse überwachen und Indexempfehlungen abrufen, um die Datenbankleistung zu optimieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, in dem Sie die Tools verwenden möchten, um die Berechtigungen zu erhalten, die Sie zur Verwendung der vordefinierten AlloyDB-Beobachtbarkeitskonfigurationen in MCP Toolbox for Databases benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die für die Verwendung der vordefinierten AlloyDB-Beobachtbarkeitskonfigurationen in der MCP Toolbox for Databases erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um die vordefinierten Konfigurationen für die AlloyDB-Beobachtbarkeit in der MCP Toolbox for Databases zu verwenden:

  • Abfragemesswerte abrufen: queryMetrics.fetch
  • Systemmesswerte abrufen: systemMetrics.fetch
  • Erweiterte aggregierte Abfragestatistiken abrufen: queryStats.fetch
  • Erweiterte Zeitreihen-Abfragestatistiken abrufen: queryTimeSeries.fetch
  • Erweiterte aggregierte Statistiken zu Warteereignissen abrufen: waitEventStats.fetch
  • Erweiterte Zeitreihenstatistiken für Warteereignisse abrufen: waitEventTimeSeries.fetch
  • Indexempfehlungen abrufen: recommendations.query, resourceRecommendations.query
  • Monitoring-Messwerte ansehen: monitoring.timeseries.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Wenn Sie Ihre IDE so konfigurieren möchten, dass die vordefinierte Konfiguration alloydb-postgres-observability verwendet wird, fügen Sie der MCP-Konfigurationsdatei Ihres Clients die folgende Konfiguration hinzu.

Weitere Informationen finden Sie in der Dokumentation zur MCP Toolbox für Datenbanken: AlloyDB for PostgreSQL.

{
  "mcpServers": {
    "alloydb-observability": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-observability", "--stdio"]
    }
  }
}

Wenn Sie eine Verbindung mit dieser vordefinierten Konfiguration herstellen, kann Ihr Agent die folgenden erweiterten Query Insights-Tools von AlloyDB aufrufen, um Leistungsprobleme zu beheben:

  • get_advanced_aggregated_query_stats: Ruft aggregierte Statistiken zur Abfrageausführung ab.
  • get_advanced_aggregated_wait_event_stats: Ruft aggregierte Messwerte zu Engpässen bei Warteereignissen ab.
  • get_advanced_time_series_query_stats: Ruft Zeitachsen-Leistungsmesswerte für Abfragen im Zeitverlauf ab.
  • get_advanced_time_series_wait_event_stats: Ruft Zeitreihenmesswerte für Warteereignisse im Zeitverlauf ab.
  • get_index_recommendations: Ruft Indexempfehlungen ab, um die Abfrageleistung zu optimieren.

Verbindung über das Data Agent Kit herstellen

Mit dem Google Cloud Data Agent Kit können Sie direkt in VS Code, VS Code-basierten IDEs und unterstützten CLIs eine Verbindung zu Ihrer AlloyDB-Datenbank herstellen und Abfragen ausführen.

Die Verwendung des Data Agent Kit bietet unter anderem folgende Vorteile:

  • Funktionen zur Datenerkennung und -exploration, mit denen Sie Fragen zu Ihren AlloyDB-Daten in natürlicher Sprache stellen können
  • Kein Kontextwechsel mehr zwischen AlloyDB-Tools und Ihrer Entwicklungsumgebung
  • Plug-ins, mit denen Sie interaktive Befehlszeilen mit Ihren Google Cloud -Ressourcen verwenden können

Weitere Informationen finden Sie unter Data Agent Kit – Übersicht.