Utiliser AlloyDB Omni avec MCP, la CLI Gemini et d'autres agents

Sélectionnez une version de la documentation :

Ce document explique comment connecter votre instance AlloyDB Omni à différents agents compatibles avec le protocole MCP (Model Context Protocol).

Comme AlloyDB Omni est compatible avec PostgreSQL, vous pouvez utiliser des outils et des extensions conçus pour PostgreSQL.

Pour une configuration plus simple, utilisez l'extension PostgreSQL dédiée pour Gemini CLI. Elle intègre directement le serveur MCP sous-jacent dans l'extension, ce qui vous évite d'avoir à configurer un serveur distinct. Vous pouvez configurer Gemini Code Assist pour qu'il utilise Gemini CLI, ce qui offre des avantages de configuration similaires dans votre IDE.

Vous pouvez également connecter d'autres IDE et agents compatibles avec le protocole MCP via MCP Toolbox for Databases. Toolbox est un serveur MCP Open Source conçu pour connecter des agents IA à vos données. Il gère des tâches telles que l'authentification et le regroupement de connexions, ce qui vous permet d'interagir avec vos données en langage naturel directement depuis votre IDE.

Avant de commencer

Avant de vous connecter à votre instance AlloyDB Omni, procédez comme suit :

  1. Installez AlloyDB Omni pour Linux et disposez d'une instance de base de données en cours d'exécution.
  2. Créez ou réutilisez un utilisateur de base de données. Préparez-vous à saisir le nom d'utilisateur et le mot de passe.

Utiliser l'extension Gemini CLI pour PostgreSQL

Gemini CLI est un agent IA Open Source conçu pour faciliter les workflows de développement en vous aidant à coder, à déboguer, à explorer des données et à créer du contenu. Son objectif est de fournir une interface agentique pour interagir avec les services Data Cloud et les bases de données Open Source populaires.

L'intégration à Gemini CLI pour AlloyDB Omni s'effectue via l'extension PostgreSQL. Cette extension fournit un ensemble d'outils permettant d'interagir avec PostgreSQL et AlloyDB Omni. Vous pouvez ainsi gérer vos bases de données, exécuter des requêtes et explorer des schémas directement depuis Gemini CLI à l'aide de requêtes en langage naturel.

Les exemples suivants utilisent un exemple de base de données ecommerce avec les tables suivantes :

  • products : contient des informations produit, y compris product_id, product_name, category et price.
  • customers : stocke les données client, telles que customer_id, first_name, last_name et email.
  • orders : contient des informations sur les commandes, y compris order_id, customer_id et order_date.

Les outils suivants sont disponibles dans l'extension PostgreSQL :

Catégorie Outil Exemple de requête en langage naturel
Opérations de base de données execute_sql Affichez les 10 produits les plus chers de la catégorie "Ordinateurs portables".
get_query_plan Expliquez le plan de requête pour une requête qui recherche tous les clients qui n'ont pas passé de commande au cours des six derniers mois.
list_active_queries Quelles requêtes sont en cours d'exécution dans la base de données ?
database_overview Donnez-moi une vue d'ensemble de la base de données actuelle.
list_tables Affichez toutes les tables de la base de données actuelle.
list_views Quelles vues sont disponibles ?
list_schemas Répertoriez tous les schémas.
list_triggers Affichez les déclencheurs de la table des commandes.
list_available_extensions Quelles extensions disponibles puis-je installer ?
list_installed_extensions Répertoriez toutes les extensions installées.
list_indexes Répertoriez tous les index.
list_sequences Répertoriez toutes les séquences.
État et maintenance de la base de données list_autovacuum_configurations Affichez la configuration autovacuum actuelle.
list_memory_configurations Quelles sont les configurations de mémoire actuelles ?
list_top_bloated_tables Répertoriez les cinq tables les plus volumineuses.
list_replication_slots Affichez tous les emplacements de réplication actifs.
list_invalid_indexes Recherchez les index non valides dans la base de données ecommerce.
long_running_transactions Affichez les transactions de longue durée.
list_locks Répertoriez tous les verrous.
replication_stats Affichez les statistiques de réplication.

Vous pouvez utiliser l'extension Gemini CLI pour PostgreSQL de deux manières :

  • Outil de ligne de commande autonome
  • Intégré à votre IDE avec Gemini Code Assist

Gemini CLI

  1. Installez le Gemini CLI (version 0.6.0 ou ultérieure).
  2. Installez l'extension 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
  3. Définissez des variables d'environnement pour vous connecter à votre instance AlloyDB Omni : 
    export POSTGRES_HOST="DATABASE_HOST"
export POSTGRES_PORT="DATABASE_PORT"
export POSTGRES_DATABASE="DATABASE_NAME"
export POSTGRES_USER="DATABASE_USER"
export POSTGRES_PASSWORD="DATABASE_PASSWORD"

    Vous pouvez également charger ces variables à partir d'un fichier .env dans votre répertoire de travail.

  4. Démarrez Gemini CLI en mode interactif : 
    gemini
     La CLI charge automatiquement l'extension PostgreSQL et ses outils, que vous pouvez utiliser pour interagir avec votre base de données.

Gemini Code Assist

Pour éviter de configurer manuellement un serveur MCP, configurez Gemini Code Assist pour qu'il utilise Gemini CLI.

  1. Installez et configurez Gemini CLI et l'postgres extension, comme décrit dans l'onglet Gemini CLI.
  2. Configurez Gemini Code Assist pour qu'il utilise Gemini CLI.
  3. Commencez à interagir avec votre instance AlloyDB Omni en langage naturel directement dans le chat Gemini Code Assist.

Se connecter à d'autres IDE à l'aide de MCP Toolbox for Databases

Cette section explique comment vous connecter à votre instance AlloyDB Omni à partir de différents agents à l'aide de MCP Toolbox for Databases.

Installer MCP Toolbox for Databases

Pour connecter votre IDE à AlloyDB Omni, vous devez installer MCP Toolbox for Databases, un serveur Open Source qui connecte des agents IA à vos données.

  1. Téléchargez la dernière version de Toolbox en tant que fichier binaire. Sélectionnez le binaire correspondant à votre système d'exploitation (OS) et à l'architecture de votre processeur.

    linux/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/linux/amd64/toolbox

    darwin/arm64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/darwin/arm64/toolbox

    darwin/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/darwin/amd64/toolbox

    windows/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/windows/amd64/toolbox.exe

  2. Rendez le fichier binaire exécutable.

    chmod +x toolbox

  3. Vérifiez l'installation.

    ./toolbox --version

Configurer votre client

Sélectionnez votre outil d'agent parmi les options suivantes :

Cursor

  1. Créez le répertoire .cursor à la racine de votre projet s'il n'existe pas.
  2. Créez le fichier .cursor/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.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. 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.

Windsurf

  1. Ouvrez Windsurf, puis accédez à l'assistant Cascade.
  2. Cliquez 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": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}

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": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}

Cline

  1. Ouvrez l'extension Cline dans VS Code, puis cliquez sur l'icône MCP Servers.
  2. Cliquez 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": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Un état actif vert s'affiche une fois la connexion au serveur établie.

Claude desktop

  1. Ouvrez Claude Desktop, puis accédez à Settings (Paramètres).
  2. Dans l'onglet Developer (Développeur), cliquez sur Edit Config (Modifier la configuration) pour ouvrir le fichier de configuration.
  3. Ajoutez la configuration, remplacez les variables d'environnement par vos valeurs, puis enregistrez.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Redémarrez Claude Desktop.
  2. Le nouvel écran de chat affiche une icône de marteau (MCP) avec le nouveau serveur MCP.

Claude code

  1. Installez Claude Code.
  2. Créez le fichier .mcp.json à la racine de votre projet s'il n'existe pas.
  3. Ajoutez la configuration, remplacez les variables d'environnement par vos valeurs, puis enregistrez.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. Redémarrez Claude Code pour appliquer la nouvelle configuration.