Cloud SQL for MySQL mit MCP, Gemini CLI und anderen Agents verwenden

Auf dieser Seite erfahren Sie, wie Sie Ihre Cloud SQL-Instanz mit verschiedenen KI-Tools für Entwickler verbinden, darunter:

Für eine integrierte Nutzung empfehlen wir die Verwendung der dedizierten Gemini CLI-Erweiterung für Cloud SQL for MySQL.

Als Befehlszeile der nächsten Generation von Google Cloudenthält die Gemini CLI die zugrunde liegenden Funktionen direkt in der Erweiterung, was die Einrichtung und Konfiguration vereinfacht. Sie können Gemini Code Assist so konfigurieren, dass die Gemini CLI verwendet wird. Das bietet ähnliche Einrichtungsvorteile in Ihrer IDE.

Bei anderen Entwicklertools, die das Model Context Protocol (MCP) unterstützen, können Sie eine Verbindung herstellen, indem Sie die MCP Toolbox for Databases (Toolbox) manuell konfigurieren. Die Toolbox ist ein Open-Source-MCP-Server, der KI-Agents mit Ihren Daten verbindet, indem er Aufgaben wie die Authentifizierung und das Connection Pooling verwaltet. So können Sie direkt über Ihre IDE in natürlicher Sprache mit Ihren Daten interagieren. Für diese Tools bietet diese Methode grundlegende Funktionen für die Datenbankinteraktion.

Weitere Informationen finden Sie unter Vorgefertigte Tools und MCP Toolbox for Databases auf GitHub.

Gemini CLI und Erweiterungen

Die Gemini CLI ist ein Open-Source-KI-Agent, der Sie bei der Entwicklung unterstützt, indem er Ihnen beim Programmieren, Debuggen, bei der Datenexploration und beim Erstellen von Inhalten hilft. Sie bietet eine Agent-Schnittstelle für die Interaktion mit Datenbank- und Analysediensten sowie gängigen Open-Source-Datenbanken.

Funktionsweise von Erweiterungen

Die Gemini CLI ist sehr flexibel und kann durch Erweiterungen um neue Tools und Funktionen ergänzt werden. Sie können die Erweiterungen über eine GitHub-URL, ein lokales Verzeichnis oder eine konfigurierbare Registry laden. Sie bieten neue Tools, Slash-Befehle, Skills und Prompts, die Sie bei Ihrem Workflow unterstützen.

Gemini CLI-Erweiterungen in Cloud SQL for MySQL verwenden

Die Cloud SQL Gemini CLI-Erweiterung basiert auf der MCP Toolbox für Datenbanken.

Die Integration in die Gemini CLI erfolgt über eine spezielle Erweiterung, die im Vergleich zur Standard-Toolbox-Verbindung zusätzliche Funktionen bietet. Die Erweiterung bietet einen optimierten Installationsprozess und eine Reihe von Skills, die auf MCP-Tools basieren.

Weitere Informationen finden Sie in der GitHub-Dokumentation zur Gemini CLI-Erweiterung für Cloud SQL for MySQL.

Gemini CLI-Erweiterung für Cloud SQL for MySQL-Datenbanken

Die cloud-sql-mysql-Erweiterung umfasst Skills zum Abfragen der Datenbank und zum Überwachen des Datenbankstatus.

Eine Liste aller verfügbaren Cloud SQL-Skills auf GitHub finden Sie hier.

Die cloud-sql-mysql-observability-Erweiterung bietet eine einheitliche Schnittstelle zum Verwalten und Überwachen der Datenbankleistung und des Datenbankzustands direkt über die Gemini CLI.

Kategorie Tools
Beobachtbarkeit
  • get_system_metrics: Ruft Systemmesswerte für eine Cloud SQL-Instanz ab.
  • get_query_metrics: Ruft abfragebezogene Messwerte für eine Cloud SQL-Instanz ab.

Gemini CLI-Erweiterung für MySQL-Datenbanken

Eine Liste dieser Vorgänge finden Sie unter MCP Toolbox for Databases und Gemini CLI-Erweiterung für MySQL.

Hinweis

Mit dem Data Agent Kit verbinden

Mit der Erweiterung „Google Cloud Data Agent Kit“ können Sie eine Verbindung zu Cloud SQL herstellen und Cloud SQL-Daten abfragen. Das ist über Visual Studio Code oder eine beliebige auf VS Code basierende IDE möglich. Damit können Sie eine Verbindung zu MCP-Servern herstellen, Daten abfragen und Data-Engineering-Arbeitslasten über Ihre IDE ausführen. Das Data Agent Kit bietet auch CLI-Plug-ins.

Weitere Informationen finden Sie unter Übersicht über das Data Agent Kit.

Mit Antigravity verbinden

Sie können Cloud SQL for MySQL auf folgende Arten mit Antigravity verbinden:

  • MCP Store verwenden
  • Benutzerdefinierte Konfiguration verwenden

MCP Store

Die empfohlene Methode zum Herstellen einer Verbindung zu Cloud SQL for MySQL in Antigravity ist die Verwendung des integrierten MCP-Stores.

  1. Öffnen Sie Antigravity und dann das Agent-Steuerfeld des Editors.
  2. Klicken Sie oben im Bereich auf das Symbol … und wählen Sie MCP-Server aus.
  3. Suchen Sie in der Liste der verfügbaren Server nach Cloud SQL for MySQL und klicken Sie auf Installieren.
  4. Folgen Sie der Anleitung auf dem Bildschirm, um Ihre Konten gegebenenfalls sicher zu verknüpfen.

Nachdem Sie Cloud SQL for MySQL im MCP Store installiert haben, sind Ressourcen und Tools vom Server automatisch für den Editor verfügbar.

Benutzerdefinierte Konfiguration

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

  1. Öffnen Sie Antigravity und dann das Agent-Steuerfeld des Editors.
  2. Klicken Sie oben im Bereich auf das Symbol … und wählen Sie MCP-Server aus.
  3. Klicken Sie auf MCP-Server verwalten > Rohkonfiguration ansehen, um die mcp_config.json-Datei zu öffnen.
  4. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
{
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
          "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MYSQL_REGION": "REGION",
          "CLOUD_SQL_MYSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MYSQL_USER": "USER_ID",
          "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Nachdem Sie den benutzerdefinierten MCP-Server konfiguriert haben, sind die Ressourcen und Tools des Cloud SQL for MySQL-Servers für den Editor verfügbar.

MCP-Toolbox installieren

  1. Laden Sie das Binärprogramm herunter, das Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht.

    linux/amd64

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

    darwin/arm64

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

    darwin/amd64

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

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
  2. So machen Sie die Binärdatei ausführbar: 
    chmod +x toolbox
  3. Prüfen Sie die Installation mit dem folgenden Befehl: 
    ./toolbox --version

MCP-Client konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie verschiedene Entwicklertools konfigurieren, um mithilfe von Toolbox eine Verbindung zu Ihrer Cloud SQL-Instanz herzustellen. Toolbox fungiert als Open-Source-Model Context Protocol (MCP)-Server, der sich zwischen Ihrer IDE und Ihrer Datenbank befindet und eine sichere und effiziente Steuerungsebene für Ihre KI-Tools bietet. Wählen Sie den Tab für Ihr Tool aus, um die Konfigurationsanleitung aufzurufen.

Gemini CLI für Cloud SQL for MySQL


  1. Installieren Sie die Gemini CLI.
  2. Installieren Sie die Cloud SQL for MySQL-Erweiterung für die Gemini CLI aus dem GitHub-Repository mit dem folgenden Befehl: 
    gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
    Ersetzen Sie bei der Installation der Erweiterung Folgendes: 
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
export CLOUD_SQL_MYSQL_REGION="REGION"
export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
    Ersetzen Sie Folgendes:
    • PROJECT_NAME: Die Google Cloud Projekt-ID.
    • REGION: Die Region Ihrer Cloud SQL-Instanz.
    • INSTANCE_NAME: Die ID Ihrer Cloud SQL-Instanz.
    • DATABASE_NAME: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
    • DATABASE_USER_NAME: Optional: Der Datenbanknutzername. Wenn nichts angegeben ist, wird standardmäßig die IAM-Authentifizierung verwendet.
    • PASSWORD: Optional: Das Passwort für den Datenbanknutzer. Wenn nichts angegeben ist, wird standardmäßig die IAM-Authentifizierung verwendet.
    • IP_TYPE: Optional: Der IP-Typ, z. B. „Public“ (Standard) oder „Private“.
  3. Starten Sie die Gemini CLI im interaktiven Modus: 
    gemini

    Die CLI lädt automatisch die Gemini CLI-Erweiterung für Cloud SQL und die zugehörigen Tools, mit denen Sie mit Ihrer Datenbank interagieren können.

    Verwenden Sie in der Gemini CLI den Befehl /extensions, um zu prüfen, ob die Erweiterung installiert ist, und den Befehl /mcp list, um die Tools aufzurufen.

Gemini CLI für MySQL


  1. Installieren Sie die Gemini CLI.
  2. Installieren Sie die MySQL-Softwareerweiterung für die Gemini CLI aus dem GitHub-Repository mit dem folgenden Befehl: 
    gemini extensions install https://github.com/gemini-cli-extensions/mysql
     Ersetzen Sie bei der Installation der Erweiterung Folgendes: 
    export MYSQL_HOST="HOST"
export MYSQL_PORT="PORT"
export MYSQL_DATABASE="DATABASE"
export MYSQL_USER="USER"
export MYSQL_PASSWORD="PASSWORD"
export MYSQL_QUERY_PARAMETERS="QUERY_PARAMETERS"
    Ersetzen Sie Folgendes:
    • HOST: Der Hostname oder die IP-Adresse des MySQL-Servers.
    • PORT: Die Portnummer für den MySQL-Server.
    • DATABASE: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
    • USER: Der Datenbanknutzername.
    • PASSWORD: Das Passwort für den Datenbanknutzer.
    • QUERY_PARAMETERS: Optional: Die Rohabfrage, die dem db-Verbindungsstring hinzugefügt werden soll.
  3. Starten Sie die Gemini CLI im interaktiven Modus: 
    gemini

    Die CLI lädt automatisch die Gemini CLI-Erweiterung für MySQL und die zugehörigen Tools, mit denen Sie mit Ihrer Datenbank interagieren können.

Gemini Code Assist


  1. Installieren Sie die Erweiterung Gemini Code Assist in Visual Studio Code.
  2. Aktivieren Sie den KI-Agentenmodus 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. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei:

    {
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
          "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MYSQL_REGION": "REGION",
          "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
          "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MYSQL_USER": "USER_ID",
          "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude-Code


  1. Installieren Sie Claude Code.
  2. Legen Sie Umgebungsvariablen fest, um eine Verbindung zu Ihrer Cloud SQL-Instanz herzustellen: 
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
export CLOUD_SQL_MYSQL_REGION="REGION"
export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
    Ersetzen Sie Folgendes:
    • PROJECT_NAME: Die Google Cloud Projekt-ID.
    • REGION: Die Region Ihrer Cloud SQL-Instanz.
    • INSTANCE_NAME: Die ID Ihrer Cloud SQL-Instanz.
    • DATABASE_NAME: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
    • DATABASE_USER_NAME: Optional: Der Datenbanknutzername. Wenn nichts angegeben ist, wird standardmäßig die IAM-Authentifizierung verwendet.
    • PASSWORD: Optional: Das Passwort für den Datenbanknutzer. Wenn nichts angegeben ist, wird standardmäßig die IAM-Authentifizierung verwendet.
    • IP_TYPE: Optional: Der IP-Typ, z. B. „Public“ (Standard) oder „Private“.
  3. Starten Sie den Agent: 
    claude
  4. Installieren Sie das Plug-in: 
    /plugin install cloud-sql-mysql@claude-plugins-official

Claude für den Computer


  1. Öffnen Sie Claude für Desktop und rufen Sie die Einstellungen auf.
  2. Tippen Sie auf dem Tab Entwickler auf Konfiguration bearbeiten, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie Folgendes hinzu, um eine Verbindung zum MCP-Server herzustellen und die Umgebungsvariablen festzulegen: 

    {
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}
  4. Starten Sie Claude für den Computer neu. Auf dem neuen Chatbildschirm wird das MCP-Symbol mit dem neuen verfügbaren MCP-Server angezeigt.

Codex


  1. Installieren Sie den Data Cloud-Plug-ins-Marketplace: 
    codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
  2. Plug-in installieren:
    codex plugin install cloud-sql-mysql@data-cloud-plugins
  3. Konfigurieren Sie die Umgebungsvariablen, um eine Verbindung zu Ihrer Cloud SQL-Instanz herzustellen: 
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
export CLOUD_SQL_MYSQL_REGION="REGION"
export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
     Ersetzen Sie Folgendes:
    • PROJECT_NAME: Die Google Cloud Projekt-ID.
    • REGION: Die Region Ihrer Cloud SQL-Instanz.
    • INSTANCE_NAME: Die ID Ihrer Cloud SQL-Instanz.
    • DATABASE_NAME: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
    • DATABASE_USER_NAME: Optional: Der Datenbanknutzername. Wenn nichts angegeben ist, wird standardmäßig die IAM-Authentifizierung verwendet.
    • PASSWORD: Optional: Das Passwort für den Datenbanknutzer. Wenn nichts angegeben ist, wird standardmäßig die IAM-Authentifizierung verwendet.
    • IP_TYPE: Optional: Der IP-Typ, z. B. „Public“ (Standard) oder „Private“.
  4. Optional. Aktualisieren Sie den Marketplace: 
    codex plugin marketplace upgrade data-agent-plugins
  5. Führen Sie codex plugin list aus oder verwenden Sie das interaktive Menü plugins, um die installierten Plug-ins zu überprüfen.

Cline


  1. Öffnen Sie die Cline-Erweiterung in VS Code und tippen Sie auf das Symbol MCP-Server.
  2. Tippen 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": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}
    Nach erfolgreicher Verbindung des Servers wird ein grüner Status „Aktiv“ 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": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}
  4. Öffnen Sie Cursor und rufen Sie Einstellungen > Cursoreinstellungen > MCP auf. Wenn der Server verbunden ist, wird ein grüner aktiver Status 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": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Windsurf


  1. Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
  2. Tippen 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": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
          "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MYSQL_REGION": "REGION",
          "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
          "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MYSQL_USER": "USER_ID",
          "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}