Utiliser Cloud SQL pour SQL Server avec MCP, Gemini CLI et d'autres agents

MySQL | PostgreSQL | SQL Server

Cette page vous explique comment connecter votre instance Cloud SQL à différents outils d'assistance pour les développeurs d'IA, y compris les suivants :

• Extension Gemini CLI pour Cloud SQL pour SQL Server
• Extension Gemini CLI pour SQL Server

• Gemini Code Assist
• Code Claude
• Claude sur ordinateur
• Codex
• Cline (extension VS Code)
• Cursor
• Visual Studio Code (Copilot)
• Windsurf (Codeium)
• Antigravity

Pour une expérience intégrée, nous vous recommandons d'utiliser l'extension CLI Gemini dédiée pour Cloud SQL pour SQL Server.

En tant qu'interface de ligne de commande de nouvelle génération d' Google Cloud, Gemini CLI regroupe les compétences sous-jacentes directement dans l'extension, ce qui simplifie la configuration. Vous pouvez configurer Gemini Code Assist pour qu'il utilise la Gemini CLI, ce qui offre des avantages de configuration similaires dans votre IDE.

Pour les autres outils pour les développeurs compatibles avec le Model Context Protocol (MCP), vous pouvez vous connecter en configurant manuellement MCP Toolbox for Databases (Toolbox). Toolbox est un serveur MCP Open Source qui connecte les agents d'IA à vos données en gérant des tâches telles que l'authentification et le regroupement de connexions. Cela vous permet d'interagir avec vos données en langage naturel directement depuis votre IDE. Pour ces outils, cette méthode fournit des fonctionnalités d'interaction de base avec la base de données.

Pour en savoir plus, consultez Outils prédéfinis et MCP Toolbox for Databases sur GitHub.

À propos de la CLI Gemini et des extensions

Gemini CLI est un agent d'IA Open Source conçu pour vous aider dans vos workflows de développement en vous assistant pour le codage, le débogage, l'exploration de données et la création de contenu. Il fournit une interface agentique pour interagir avec les services de base de données et d'analyse, ainsi qu'avec les bases de données Open Source populaires.

Fonctionnement des extensions

Gemini CLI est très extensible, ce qui permet d'ajouter de nouveaux outils et de nouvelles fonctionnalités grâce aux extensions. Vous pouvez charger les extensions à partir d'une URL GitHub, d'un répertoire local ou d'un registre configurable. Ils fournissent de nouveaux outils, commandes slash, compétences et requêtes pour vous aider dans votre workflow.

Utiliser les extensions de l'interface de ligne de commande Gemini dans Cloud SQL pour SQL Server

L'extension Cloud SQL Gemini CLI est basée sur MCP Toolbox pour les bases de données.

L'intégration à Gemini CLI se fait via une extension dédiée qui offre des fonctionnalités supplémentaires par rapport à la connexion Toolbox standard. L'extension propose un processus d'installation simplifié et un ensemble de compétences basées sur les outils MCP.

Pour en savoir plus, consultez la documentation GitHub sur l'extension Gemini CLI pour Cloud SQL pour SQL Server.

Extension Gemini CLI pour les bases de données Cloud SQL pour SQL Server

L'extension cloud-sql-sqlserver inclut des compétences permettant d'interroger la base de données et de surveiller son état.

Pour connaître toutes les compétences disponibles, consultez les compétences Cloud SQL sur GitHub. L'extension cloud-sql-sqlserver-observability fournit une interface unifiée pour gérer et surveiller les performances et l'état de la base de données directement depuis la Gemini CLI.

Catégorie	Outils
Observabilité	get_system_metrics : récupère les métriques système pour une instance Cloud SQL.

Extension Gemini CLI pour les bases de données SQL Server

Pour obtenir la liste de ces opérations, consultez MCP Toolbox pour les bases de données et Extension Gemini CLI pour SQL Server.

Avant de commencer

• Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud .

• Assurez-vous que la facturation est activée pour votre projet Google Cloud .

• Activez l'API Cloud SQL Admin dans le projet Google Cloud .

• Par défaut, Cloud SQL attribue une adresse IP publique à une nouvelle instance. Selon votre cas d'utilisation, assurez-vous qu'une adresse IP publique ou une adresse IP privée est configurée pour vos instances Cloud SQL. Toolbox se connecte de manière sécurisée à l'aide des connecteurs de langage Cloud SQL.

• Attribuez les rôles Identity and Access Management (IAM) nécessaires à l'utilisateur qui exécutera le serveur MCP. Les outils disponibles dépendent des rôles accordés :

  Tâche	Nom du rôle	Rôle IAM requis
  Fournit un accès en lecture seule aux ressources, y compris les opérations suivantes : get_instance list_instances list_databases wait_for_operation	Lecteur Cloud SQL	roles/cloudsql.viewer
  Fournit un accès en lecture seule aux données de surveillance telles que les métriques de séries temporelles.	Lecteur Cloud Monitoring	roles/monitoring.viewer
  Fournit des autorisations permettant de gérer les ressources existantes, y compris les suivantes : Tous les outils viewer create_database	Éditeur Cloud SQL	roles/cloudsql.editor
  Offre un contrôle total sur toutes les ressources, y compris les suivantes : Tous les outils viewer et editor create_instance create_user	Administrateur Cloud SQL	roles/cloudsql.admin

• Configurez les identifiants par défaut de l'application (ADC) pour votre environnement.

• Créez ou réutilisez un utilisateur de base de données, et préparez le nom d'utilisateur et le mot de passe.

Contacter Antigravity

Vous pouvez connecter Cloud SQL pour SQL Server à Antigravity de différentes manières :

• Utiliser le MCP Store
• Utiliser une configuration personnalisée

Remarque : Vous n'avez pas besoin de télécharger le binaire MCP Toolbox pour utiliser ces méthodes.

Boutique MCP

La méthode la plus recommandée pour se connecter à Cloud SQL pour SQL Server 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. Localisez Cloud SQL pour SQL Server 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 SQL Server 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-mssql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
          "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MSSQL_REGION": "REGION",
          "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MSSQL_USER": "USER_ID",
          "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Une fois le serveur MCP personnalisé configuré, les ressources et les outils du serveur Cloud SQL pour SQL Server sont disponibles pour l'éditeur.

Installer MCP Toolbox

Remarque : Cette étape n'est pas obligatoire pour les extensions de la CLI Gemini.

1. Téléchargez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur.

   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. Rendez le binaire exécutable :

   chmod +x toolbox

3. Vérifiez l'installation à l'aide de la commande suivante :

   ./toolbox --version

Configurer le client MCP

Cette section explique comment configurer différents outils pour les développeurs afin de se connecter à votre instance Cloud SQL à l'aide de Toolbox. Toolbox fait office de serveur MCP (Model Context Protocol) Open Source qui se situe entre votre IDE et votre base de données. Il fournit un plan de contrôle sécurisé et efficace pour vos outils d'IA. Sélectionnez l'onglet correspondant à votre outil pour afficher les instructions de configuration.

Interface de ligne de commande Gemini pour Cloud SQL pour SQL Server

1. Installez Gemini CLI.
2. Installez l'extension Cloud SQL pour SQL Server 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-sqlserver

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

   export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
   export CLOUD_SQL_MSSQL_REGION="REGION"
   export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
   export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
   export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
   export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
   export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
   

   Remplacez les éléments suivants :
   • PROJECT_NAME : ID du projet Google Cloud .
   • 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 outils, 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 SQL Server

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

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

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

   export MSSQL_HOST="HOST"
   export MSSQL_PORT="PORT"
   export MSSQL_DATABASE="DATABASE"
   export MSSQL_USER="USER"
   export MSSQL_PASSWORD="PASSWORD"
   

   Remplacez les éléments suivants :
   • HOST : nom d'hôte ou adresse IP du serveur SQL Server.
   • PORT : numéro de port du serveur SQL Server.
   • 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.
3. Démarrez Gemini CLI en mode interactif :

   gemini

   La CLI charge automatiquement l'extension Gemini CLI pour SQL Server 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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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_MSSQL_PROJECT="PROJECT_NAME"
   export CLOUD_SQL_MSSQL_REGION="REGION"
   export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
   export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
   export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
   export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
   export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
   

   Remplacez les éléments suivants :
   • PROJECT_NAME : ID du projet Google Cloud .
   • 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-sqlserver@claude-plugins-official

Conseil : Exécutez /plugin list dans Claude Code pour vérifier que le plug-in est actif, ou /reload-plugins si vous venez de l'installer.

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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

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

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-sqlserver@data-agent-kit

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

   export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
   export CLOUD_SQL_MSSQL_REGION="REGION"
   export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
   export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
   export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
   export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
   export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
   

   Remplacez les éléments suivants :
   • PROJECT_NAME : ID du projet Google Cloud .
   • 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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }