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 le serveur MCP personnalisé configuré, les ressources et les outils du serveur Cloud SQL pour PostgreSQL sont disponibles pour l'éditeur.

Gemini CLI pour Cloud SQL pour PostgreSQL

1. Installez 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 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. Installez le plug-in :

   /plugin install cloud-sql-postgresql@claude-plugins-official

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. Installez le kit Data Agent Marketplace :

   codex plugin marketplace add GoogleCloudPlatform/data-agent-kit

2. Installez le plug-in :

   codex plugin install cloud-sql-postgresql@data-agent-kit

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. Facultatif. Mettez à jour la place de marché :

   codex plugin marketplace upgrade data-agent-kit

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 (Assistant en cascade).
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"
         }
       }
     }
   }