Cloud SQL for MySQL mit MCP, Gemini CLI und anderen Agents 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 den Agent-Bereich 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. Folge der Anleitung auf dem Bildschirm, um deine Konten gegebenenfalls sicher zu verknüpfen.

Nachdem Sie Cloud SQL for MySQL 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 Agent-Bereich 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, stehen dem Editor die Ressourcen und Tools des Cloud SQL for MySQL-Servers zur Verfügung.

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 Cloud de Confiance 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 keine Angabe erfolgt, wird standardmäßig die IAM-Authentifizierung verwendet.
   • PASSWORD: Optional: Das Passwort für den Datenbanknutzer. Wenn keine Angabe erfolgt, 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 Cloud de Confiance 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 keine Angabe erfolgt, wird standardmäßig die IAM-Authentifizierung verwendet.
   • PASSWORD: Optional: Das Passwort für den Datenbanknutzer. Wenn keine Angabe erfolgt, 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. Die aktuelle Release-Version finden Sie im Cloud SQL for MySQL Skills-Repository. Fügen Sie den Marketplace hinzu:

         /plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-mysql.git#VERSION
         

5. Installieren Sie das Plug-in:

         /plugin install cloud-sql-mysql@cloud-sql-mysql-marketplace
         

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. Die aktuelle Release-Version finden Sie im Cloud SQL for MySQL Skills-Repository. Klonen Sie sie:

   git clone --branch VERSION git@github.com:gemini-cli-extensions/cloud-sql-mysql.git
   

2. Installieren Sie das Plug-in:
   

   mkdir -p ~/.codex/plugins
   cp -R /absolute/path/to/cloud-sql-mysql ~/.codex/plugins/cloud-sql-mysql
   

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 Cloud de Confiance 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 keine Angabe erfolgt, wird standardmäßig die IAM-Authentifizierung verwendet.
   • PASSWORD: Optional: Das Passwort für den Datenbanknutzer. Wenn keine Angabe erfolgt, wird standardmäßig die IAM-Authentifizierung verwendet.
   • IP_TYPE: Optional: Der IP-Typ, z. B. „Public“ (Standard) oder „Private“.
4. Erstellen oder aktualisieren Sie die Datei „marketplace.json“:
   
   

   
   {
     "name": "my-data-cloud-google-marketplace",
     "interface": {
       "displayName": "Google Data Cloud Skills"
     },
     "plugins": [
       {
         "name": "cloud-sql-mysql",
         "source": {
           "source": "local",
           "path": "./plugins/cloud-sql-mysql"
         },
         "policy": {
           "installation": "AVAILABLE",
           "authentication": "ON_INSTALL"
         },
         "category": "Database"
       }
     ]
   }
   
   

5. Führen Sie codex plugin list aus oder verwenden Sie das interaktive Menü plugins, um die installierten Plug-ins zu prü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"
         }
       }
     }
   }
   
   

   Nachdem der Server erfolgreich verbunden wurde, wird ein grüner aktiver Status 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 gehen Sie zu Einstellungen > Cursoreinstellungen > MCP. 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"
         }
       }
     }
   }