AlloyDB-Datenbank mit der MCP Toolbox in der IDE erstellen

Auf dieser Seite wird beschrieben, wie Sie mit der MCP Toolbox for Databases Ihre AlloyDB for PostgreSQL-Cluster und -Instanzen über integrierte Entwicklungsumgebungen (IDEs) erstellen und verwalten. Sie können Entwicklertools verwenden, die das Model Context Protocol (MCP) unterstützen.

Das Model Context Protocol (MCP) ist ein offenes Protokoll zum Verbinden von Large Language Models (LLMs) mit Datenquellen und APIs wie der AlloyDB Admin API. Ein KI-Assistent ist eine auf einem LLM basierende Chatoberfläche in Ihrer IDE, die Sie dabei unterstützt, Ihre Ziele zu erreichen und Aufgaben zu erledigen. Auf dieser Seite wird beschrieben, wie Sie die MCP Toolbox for Databases verwenden, um Ihre Entwicklerassistent-Tools in einer AlloyDB-Instanz über die folgenden IDEs verfügbar zu machen:

Hinweise

  1. Wählen Sie in der Google Cloud -Console auf der Seite für die Projektauswahl ein Google Cloud -Projekt aus oder erstellen Sie eines.

  2. Die Abrechnung für Ihr Google Cloud -Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  3. Aktivieren Sie die AlloyDB Admin API.

    API aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen (Identity and Access Management) für Ihr Projekt zuzuweisen, damit Sie AlloyDB-Ressourcen verwalten können:

  • AlloyDB-Administrator (roles/alloydb.admin).
  • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

MCP-Toolbox installieren

  1. Laden Sie die aktuelle Version der MCP Toolbox als Binärdatei herunter. Wählen Sie die Binärdatei aus, die Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht. Sie müssen die MCP Toolbox-Version V0.10.0 oder höher verwenden.

    linux/amd64

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

    darwin/arm64

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

    darwin/amd64

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

    windows/amd64

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

  2. Machen Sie die Binärdatei ausführbar.

    chmod +x toolbox

  3. Prüfen Sie die Installation.

    ./toolbox --version

MCP-Client konfigurieren

Sie können Ihre IDE so konfigurieren, dass sie die Tools der Steuerungsebene zum Erstellen und Verwalten von AlloyDB-Clustern und -Instanzen verwendet. Wenn Sie bereits eine AlloyDB-Instanz haben, überspringen Sie diesen Schritt und fahren Sie mit IDE über die MCP Toolbox mit AlloyDB for PostgreSQL verbinden fort. Instanzen werden mit einer öffentlichen IP-Adresse erstellt, wenn die angegebenen Tools der Steuerungsebene verwendet werden. Fügen Sie der MCP-Einstellungsdatei Ihrer IDE die folgende Konfiguration hinzu. Bei diesem Ansatz wird das alloydb-postgres-admin-Tool für Ihren KI-Assistenten verfügbar gemacht.

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. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.
  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude für den Computer

  1. Öffnen Sie Claude Desktop und rufen Sie die Einstellungen auf.
  2. Klicken Sie auf dem Tab Entwickler auf Konfiguration bearbeiten, um die Konfigurationsdatei zu öffnen.
  3. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.

  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei.

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

Cline

  1. Öffnen Sie die Cline-Erweiterung in VS Code und tippen Sie auf das Symbol MCP Servers.
  2. Tippen Sie auf „MCP-Server konfigurieren“, um die Konfigurationsdatei zu öffnen.
  3. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.

  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei.

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

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. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.
  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei:

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

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. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.
  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei.

{
  "mcp":{
    "servers": {
      "alloydb-admin": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
        "env": {
          "API_KEY": "API_KEY"
        }
      }
    }
  }
}

Windsurfen

  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. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.

  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei.

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

Gemini CLI

  1. Installieren Sie die Gemini CLI.
  2. Erstellen Sie in Ihrem Arbeitsverzeichnis einen Ordner mit dem Namen .gemini. Erstellen Sie darin eine settings.json-Datei.
  3. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.

  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

  1. Installieren Sie die Erweiterung Gemini Code Assist in Visual Studio Code.
  2. Aktivieren Sie den Agent-Modus im Gemini Code Assist-Chat.
  3. Erstellen Sie in Ihrem Arbeitsverzeichnis einen Ordner mit dem Namen .gemini. Erstellen Sie darin eine settings.json-Datei.
  4. Generieren Sie mit gcloud auth print-access-token ein Zugriffstoken, das Sie als API_KEY verwenden können.

  1. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie API_KEY durch das generierte Token und speichern Sie die Datei:

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

Ihr KI-Tool ist jetzt über MCP mit der AlloyDB for PostgreSQL-Steuerungsebene verbunden. Bitten Sie Ihren KI-Assistenten, einen Cluster oder eine Instanz zu erstellen.

Verwaltungstools verwenden

Dem LLM stehen die folgenden Tools zur Verfügung:

  • alloydb-create-cluster: Erstellt einen AlloyDB-Cluster.
  • alloydb-create-instance: Erstellt eine AlloyDB-Instanz (PRIMARY, READ_POOL oder SECONDARY).
  • alloydb-get-operation: Fragt die Operations API ab, bis der Vorgang abgeschlossen ist.

Mit eigenen Daten verbinden

Nachdem Sie einen AlloyDB-Cluster und eine Instanz eingerichtet haben, können Sie Ihre IDE mit der Datenbank verbinden, um Ihre Daten abzufragen. Weitere Informationen finden Sie unter IDE mit der MCP Toolbox mit AlloyDB verbinden.