Utiliser Cloud SQL pour PostgreSQL avec MCP, l'interface de ligne de commande Gemini et d'autres agents

Boutique MCP

La méthode la plus recommandée pour se connecter à Cloud SQL pour PostgreSQL dans Antigravity consiste à utiliser le MCP Store intégré.

1. Ouvrez Antigravity, puis le panneau de l'agent de l'éditeur.
2. Cliquez sur l'icône "..." en haut du panneau, puis sélectionnez Serveurs MCP.
3. Recherchez Cloud SQL pour PostgreSQL dans la liste des serveurs disponibles, puis cliquez sur Installer.
4. Suivez les instructions à l'écran pour associer vos comptes de manière sécurisée, le cas échéant.

Une fois que vous avez installé Cloud SQL pour PostgreSQL dans le MCP Store, les ressources et les outils du serveur sont automatiquement disponibles dans l'éditeur.

Configuration personnalisée

Pour vous connecter à un serveur MCP personnalisé, procédez comme suit :

1. Ouvrez Antigravity, puis le panneau de l'agent de l'éditeur.
2. Cliquez sur l'icône "..." en haut du panneau, puis sélectionnez Serveurs MCP.
3. Cliquez sur Manage MCP Servers > View raw config (Gérer les serveurs MCP > Afficher la configuration brute) pour ouvrir le fichier mcp_config.json.
4. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez.

{
  "mcpServers": {
    "cloud-sql-postgres": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-postgres","--stdio"],
      "env": {
          "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_POSTGRES_REGION": "REGION",
          "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_POSTGRES_USER": "USER_ID",
          "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Une fois que vous avez configuré le serveur MCP personnalisé, l'éditeur peut accéder aux ressources et aux outils du serveur Cloud SQL pour PostgreSQL.

Gemini CLI pour Cloud SQL pour PostgreSQL

1. Installez la Gemini CLI.
2. Installez l'extension Cloud SQL pour PostgreSQL pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :

         gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgresql
         

   Lors de l'installation de l'extension, remplacez les éléments suivants :
   • PROJECT_NAME : ID du projet Cloud de Confiance .
   • REGION : région de votre instance Cloud SQL.
   • INSTANCE_NAME : ID de votre instance Cloud SQL.
   • DATABASE_NAME : nom de la base de données à laquelle se connecter.
   • DATABASE_USER_NAME : nom d'utilisateur de la base de données (facultatif). Si aucune valeur n'est spécifiée, l'authentification IAM est utilisée par défaut.
   • PASSWORD : facultatif : mot de passe de l'utilisateur de la base de données. Si aucune valeur n'est spécifiée, l'authentification IAM est utilisée par défaut.
   • IP_TYPE : facultatif, type d'adresse IP, tel que "Public" (par défaut) ou "Private".
3. Démarrez Gemini CLI en mode interactif :

         gemini
         

   La CLI charge automatiquement l'extension Gemini CLI pour Cloud SQL et ses compétences, que vous pouvez utiliser pour interagir avec votre base de données.

   Dans la Gemini CLI, exécutez la commande /extensions pour vérifier que l'extension est installée et la commande /mcp list pour afficher les outils.

Gemini CLI pour PostgreSQL

1. Installez la Gemini CLI.
2. Installez l'extension logicielle PostgreSQL pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :

         gemini extensions install https://github.com/gemini-cli-extensions/postgres
         

   Lors de l'installation de l'extension, remplacez les éléments suivants :

         export POSTGRES_HOST="HOST"
         export POSTGRES_PORT="PORT"
         export POSTGRES_DATABASE="DATABASE"
         export POSTGRES_USER="USER"
         export POSTGRES_PASSWORD="PASSWORD"
         export POSTGRES_QUERY_PARAMETERS="QUERY_PARAMETERS"
         

   Remplacez les éléments suivants :
   • HOST : nom d'hôte ou adresse IP du serveur PostgreSQL.
   • PORT : numéro de port du serveur PostgreSQL.
   • DATABASE : nom de la base de données à laquelle se connecter.
   • USER : nom d'utilisateur de la base de données.
   • PASSWORD : mot de passe de l'utilisateur de la base de données.
   • QUERY_PARAMETERS : (facultatif) requête brute à ajouter à la chaîne de connexion db.
3. Démarrez Gemini CLI en mode interactif :

         gemini
         

   La CLI charge automatiquement l'extension Gemini CLI pour PostgreSQL et ses outils, que vous pouvez utiliser pour interagir avec votre base de données.

Gemini Code Assist

1. Installez l'extension Gemini Code Assist dans Visual Studio Code.
2. Activez le mode Agent dans le chat Gemini Code Assist.
3. Dans votre répertoire de travail, créez un dossier nommé .gemini. Dans ce dossier, créez un fichier settings.json.
4. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :

   
   {
     "mcpServers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Claude Code

1. Installez Claude Code.
2. Définissez des variables d'environnement pour vous connecter à votre instance Cloud SQL :

         export CLOUD_SQL_POSTGRES_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_POSTGRES_REGION="REGION"
         export CLOUD_SQL_POSTGRES_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_POSTGRES_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_POSTGRES_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_POSTGRES_PASSWORD="PASSWORD"
         export CLOUD_SQL_POSTGRES_IP_TYPE="IP_TYPE"
         

   Remplacez les éléments suivants :
   • PROJECT_NAME : ID du projet Cloud de Confiance .
   • REGION : région de votre instance Cloud SQL.
   • INSTANCE_NAME : ID de votre instance Cloud SQL.
   • DATABASE_NAME : nom de la base de données à laquelle se connecter.
   • DATABASE_USER_NAME : nom d'utilisateur de la base de données (facultatif). Si aucune valeur n'est spécifiée, l'authentification IAM est utilisée par défaut.
   • PASSWORD : facultatif : mot de passe de l'utilisateur de la base de données. Si aucune valeur n'est spécifiée, l'authentification IAM est utilisée par défaut.
   • IP_TYPE : facultatif, type d'adresse IP, tel que "Public" (par défaut) ou "Private".
3. Démarrez l'agent :

         claude
         

4. Recherchez la dernière version sur le dépôt de compétences Cloud SQL pour PostgreSQL et ajoutez la place de marché :

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

5. Installez le plug-in :

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

Claude sur ordinateur

1. Ouvrez Claude Desktop et accédez à Settings (Paramètres).
2. Dans l'onglet Développeur, appuyez sur Modifier la configuration pour ouvrir le fichier de configuration.
3. Ajoutez les éléments suivants pour vous connecter au serveur MCP et définir les variables d'environnement :

   
   {
     "mcpServers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
       }
     }
   }
   }
   
   

4. Redémarrez Claude Desktop. Le nouvel écran de chat affiche l'icône MCP avec le nouveau serveur MCP disponible.

Cline

1. Ouvrez l'extension Cline dans VS Code, puis appuyez sur l'icône Serveurs MCP.
2. Appuyez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.
3. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :

   
   {
     "mcpServers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

   Un état actif vert s'affiche une fois le serveur connecté.

Codex

1. Recherchez la dernière version dans le dépôt de compétences Cloud SQL pour PostgreSQL et clonez-la :

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

2. Installez le plug-in :

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

3. Configurez les variables d'environnement pour vous connecter à votre instance Cloud SQL :

       export CLOUD_SQL_POSTGRES_PROJECT="PROJECT_NAME"
       export CLOUD_SQL_POSTGRES_REGION="REGION"
       export CLOUD_SQL_POSTGRES_INSTANCE="INSTANCE_NAME"
       export CLOUD_SQL_POSTGRES_DATABASE="DATABASE_NAME"
       export CLOUD_SQL_POSTGRES_USER="DATABASE_USER_NAME"
       export CLOUD_SQL_POSTGRES_PASSWORD="PASSWORD"
       export CLOUD_SQL_POSTGRES_IP_TYPE="IP_TYPE"
       

   Remplacez les éléments suivants :
   • PROJECT_NAME : ID du projet Cloud de Confiance .
   • REGION : région de votre instance Cloud SQL.
   • INSTANCE_NAME : ID de votre instance Cloud SQL.
   • DATABASE_NAME : nom de la base de données à laquelle se connecter.
   • DATABASE_USER_NAME : nom d'utilisateur de la base de données (facultatif). Si aucune valeur n'est spécifiée, l'authentification IAM est utilisée par défaut.
   • PASSWORD : facultatif : mot de passe de l'utilisateur de la base de données. Si aucune valeur n'est spécifiée, l'authentification IAM est utilisée par défaut.
   • IP_TYPE : facultatif, type d'adresse IP, tel que "Public" (par défaut) ou "Private".
4. Créez ou mettez à jour le fichier marketplace.json :

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

5. Exécutez codex plugin list ou utilisez le menu interactif plugins pour vérifier les plug-ins installés.

Cline

1. Ouvrez l'extension Cline dans VS Code, puis appuyez sur l'icône Serveurs MCP.
2. Appuyez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.
3. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :

   
   {
     "mcpServers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

   Un état actif vert s'affiche une fois le serveur connecté.

Cursor

1. Créez le répertoire .cursor dans la racine de votre projet s'il n'existe pas.
2. Créez le fichier .cursor/mcp.json s'il n'existe pas et ouvrez-le.
3. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :

   
   {
     "mcpServers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

4. Ouvrez Cursor, puis accédez à Settings > Cursor Settings > MCP (Paramètres > Paramètres du curseur > MCP). Un état actif vert s'affiche lorsque le serveur se connecte.

Visual Studio Code (Copilot)

1. Ouvrez VS Code et créez le répertoire .vscode à la racine de votre projet s'il n'existe pas.
2. Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.
3. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :

   
   {
     "servers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Windsurf

1. Ouvrez Windsurf et accédez à Cascade assistant.
2. Appuyez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
3. Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :

   
   {
     "mcpServers": {
       "cloud-sql-postgres": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
         "env": {
           "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_POSTGRES_REGION": "REGION",
           "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_POSTGRES_USER": "USER_ID",
           "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
         }
       }
     }
   }