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

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

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

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

Pour les autres outils de développement compatibles avec le protocole MCP (Model Context Protocol), 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 les outils prédéfinis et MCP Toolbox for Databases sur GitHub.

À propos de Gemini CLI et des extensions

Gemini CLI est un agent d'IA Open Source conçu pour faciliter les workflows de développement en vous aidant à coder, à déboguer, à explorer les données et à créer du contenu. Il fournit une interface d'agent pour interagir avec les services de base de données et d'analyse, ainsi qu'avec les bases de données Open Source courantes.

Fonctionnement des extensions

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

Utiliser les extensions Gemini CLI dans Cloud SQL pour SQL Server

L'extension Gemini CLI Cloud SQL est basée sur MCP Toolbox for Databases.

L'intégration à Gemini CLI s'effectue 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 pour interroger la base de données et surveiller son état.

Pour obtenir la liste de 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 Gemini CLI.

Catégorie Outils
Observabilité
  • get_system_metrics : récupère les métriques système d'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 for Databases et l'extension Gemini CLI pour SQL Server.

Avant de commencer

Se connecter avec Antigravity

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

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

MCP Store

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. En haut du panneau, cliquez sur l'icône "..." , puis sélectionnez MCP Servers (Serveurs MCP).
  3. Dans la liste des serveurs disponibles, recherchez Cloud SQL for SQL Server (Cloud SQL pour SQL Server), puis cliquez sur Install (Installer).
  4. Suivez les instructions à l'écran pour lier 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 pour 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. En haut du panneau, cliquez sur l'icône "..." , puis sélectionnez MCP Servers (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 que vous avez configuré le serveur MCP personnalisé, les ressources et les outils du serveur Cloud SQL pour SQL Server sont disponibles pour l'éditeur.

Installer MCP Toolbox

<div>
<devsite-selector>
<section>
<h3 id="linux-amd64">linux/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox</pre>
</section>
<section>
<h3 id="darwin-arm64">darwin/arm64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox</pre>
</section>
<section>
<h3 id="darwin-amd64">darwin/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox</pre>
</section>
<section>
<h3 id="windows-amd64">windows/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox</pre>
</section>
</devsite-selector>
</div>

  • Rendez le binaire exécutable :

    ```bash
chmod +x toolbox
```

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

    ```bash
./toolbox --version
```

    • Configurer le client MCP

    Cette section explique comment configurer différents outils de développement pour vous 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, fournissant ainsi un plan de contrôle sécurisé et efficace pour vos outils d'IA. Sélectionnez l'onglet correspondant à votre outil spécifique pour afficher les instructions de configuration.

    Gemini CLI pour Cloud SQL pour SQL Server


    1. Installez le Gemini CLI.
    2. Installez l'extension Cloud SQL pour SQL Server pour Gemini CLI à partir du dépôt GitHub repository à 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 Google Cloud projet.
      • 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 : facultatif : nom d'utilisateur de la base de données. Prend la valeur par défaut de l'authentification IAM s'il n'est pas spécifié.
      • PASSWORD : facultatif : mot de passe de l'utilisateur de la base de données. Prend la valeur par défaut de l'authentification IAM s'il n'est pas spécifié.
      • IP_TYPE : facultatif : type d'adresse IP, par exemple "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 Gemini CLI, exécutez la /extensions pour vérifier que l'extension est installée et la /mcp list pour afficher les outils.

    Gemini CLI pour SQL Server


    1. Installez le 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"
      }
    }
  }
}

    Code Claude


    1. Installez Code Claude.
    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 Google Cloud projet.
      • 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 : facultatif : nom d'utilisateur de la base de données. Prend la valeur par défaut de l'authentification IAM s'il n'est pas spécifié.
      • PASSWORD : facultatif : mot de passe de l'utilisateur de la base de données. Prend la valeur par défaut de l'authentification IAM s'il n'est pas spécifié.
      • IP_TYPE : facultatif : type d'adresse IP, par exemple "Public" (par défaut) ou "Private".
    3. Démarrez l'agent : 
            claude
    4. Recherchez la dernière version dans le dépôt de compétences Cloud SQL pour SQL Server et ajoutez le Marketplace : 
            /plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git#VERSION
    5. Installez le plug-in : 
            /plugin install cloud-sql-sqlserver@cloud-sql-sqlserver-marketplace

    Claude Desktop


    1. Ouvrez Claude Desktop et accédez à Settings (Paramètres).
    2. Dans l'onglet Developer (Développeur), appuyez sur Edit Config (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. Recherchez la dernière version dans le dépôt de compétences Cloud SQL pour SQL Server et clonez-la : 
      git clone --branch VERSION git@github.com:gemini-cli-extensions/cloud-sql-sqlserver.git
    2. Installez le plug-in : 
      mkdir -p ~/.codex/plugins
cp -R /absolute/path/to/cloud-sql-sqlserver ~/.codex/plugins/cloud-sql-sqlserver
    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 Google Cloud projet.
      • 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 : facultatif : nom d'utilisateur de la base de données. Prend la valeur par défaut de l'authentification IAM s'il n'est pas spécifié.
      • PASSWORD : facultatif : mot de passe de l'utilisateur de la base de données. Prend la valeur par défaut de l'authentification IAM s'il n'est pas spécifié.
      • IP_TYPE : facultatif : type d'adresse IP, par exemple "Public" (par défaut) ou "Private".
    4. Créez ou mettez à jour marketplace.json : 
      
{
  "name": "my-data-cloud-google-marketplace",
  "interface": {
    "displayName": "Google Data Cloud Skills"
  },
  "plugins": [
    {
      "name": "cloud-sql-sqlserver",
      "source": {
        "source": "local",
        "path": "./plugins/cloud-sql-sqlserver"
      },
      "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 MCP Servers (Serveurs MCP).
    2. Appuyez sur Configure MCP Servers (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. Si le répertoire .cursor n'existe pas dans la racine de votre projet, créez-le.
    2. Si le fichier .cursor/mcp.json n'existe pas, créez-le 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 et 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 dans la racine de votre projet s'il n'existe pas.
    2. Si le fichier .vscode/mcp.json n'existe pas, créez-le et 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.
    2. Appuyez sur l'icône MCP, puis sur Configure (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"
      }
    }
  }
}