Créer une base de données AlloyDB à l'aide de MCP Toolbox dans un IDE

Cette page explique comment utiliser la boîte à outils MCP pour les bases de données afin de créer et de gérer vos clusters et instances AlloyDB pour PostgreSQL à partir d'environnements de développement intégrés (IDE). Vous pouvez utiliser des outils pour les développeurs compatibles avec le protocole MCP (Model Context Protocol).

Le protocole MCP (Model Context Protocol) est un protocole ouvert permettant de connecter des grands modèles de langage (LLM) à des sources de données et des API telles que l'API AlloyDB Admin. Un assistant IA est une interface de chat optimisée par un LLM dans votre IDE qui vous aide à atteindre vos objectifs et à accomplir des tâches. Cette page explique comment utiliser MCP Toolbox for Databases pour exposer vos outils d'assistance aux développeurs à une instance AlloyDB à l'aide des IDE suivants :

• Cursor
• Windsurf (Codium)
• Visual Studio Code (Copilot)
• Cline (extension VS Code)
• Claude sur ordinateur
• Code Claude
• Gemini CLI
• Gemini Code Assist

Avant de commencer

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

2. Assurez-vous que la facturation est activée pour votre projet Google Cloud . Découvrez comment vérifier si la facturation est activée sur un projet.

3. Activez l'API AlloyDB Admin.

   Activer l'API

Rôles requis

Pour gérer les ressources AlloyDB, demandez à votre administrateur de vous accorder les rôles IAM (Identity and Access Management) suivants sur votre projet :

• Administrateur AlloyDB (roles/alloydb.admin).
• Consommateur Service Usage (roles/serviceusage.serviceUsageConsumer)

Installer la boîte à outils MCP

1. Téléchargez la dernière version de MCP Toolbox en tant que fichier binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation (OS) et à l'architecture de votre processeur. Vous devez utiliser la version V0.10.0 ou ultérieure de MCP Toolbox.

   linux/amd64

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

   darwin/arm64

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

   darwin/amd64

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

   windows/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/windows/amd64/toolbox

2. Rendez le binaire exécutable.

   chmod +x toolbox
   

3. Vérifiez l'installation.

   ./toolbox --version
   

Configurer le client MCP

Vous pouvez configurer votre IDE pour qu'il utilise les outils du plan de contrôle afin de créer et de gérer des clusters et des instances AlloyDB. Si vous disposez déjà d'une instance AlloyDB, ignorez cette étape et passez à Connecter votre IDE à AlloyDB pour PostgreSQL à l'aide de la boîte à outils MCP. Les instances sont créées avec une adresse IP publique à l'aide des outils de plan de contrôle fournis. Ajoutez la configuration suivante au fichier de paramètres MCP de votre IDE. Cette approche expose l'outil alloydb-postgres-admin à votre assistant IA.

Code Claude

1. Installez Claude Code.
2. Créez un fichier .mcp.json à la racine de votre projet, s'il n'existe pas.
3. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude sur ordinateur

1. Ouvrez Claude Desktop et accédez à Settings (Paramètres).
2. Dans l'onglet Développeur, cliquez sur Modifier la configuration pour ouvrir le fichier de configuration.
3. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

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. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

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, puis ouvrez-le.
3. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez :

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Visual Studio Code (Copilot)

1. Ouvrez VS Code et créez un répertoire .vscode dans 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. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez.

{
  "mcp":{
    "servers": {
      "alloydb-admin": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
        "env": {
          "API_KEY": "API_KEY"
        }
      }
    }
  }
}

Windsurf

1. Ouvrez Windsurf et accédez à l'assistant Cascade.
2. Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
3. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini CLI

1. Installez la CLI Gemini.
2. Dans votre répertoire de travail, créez un dossier nommé .gemini. Dans ce dossier, créez un fichier settings.json.
3. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

4. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

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. Générez un jeton d'accès à utiliser comme API_KEY en exécutant gcloud auth print-access-token.

Remarque : La durée de vie du jeton est d'une heure.

5. Ajoutez la configuration suivante, remplacez API_KEY par le jeton généré, puis enregistrez :

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Votre outil d'IA est désormais connecté au plan de contrôle AlloyDB pour PostgreSQL à l'aide de MCP. Demandez à votre assistant IA de créer un cluster ou une instance.

Utiliser les outils d'administration

Les outils suivants sont à la disposition du LLM :

• alloydb-create-cluster : crée un cluster AlloyDB.
• alloydb-create-instance : crée une instance AlloyDB (PRIMARY, READ_POOL ou SECONDARY).
• alloydb-get-operation : interroge l'API Operations jusqu'à ce que l'opération soit terminée.

Associer vos données

Une fois que vous avez configuré un cluster et une instance AlloyDB, vous pouvez connecter votre IDE à la base de données pour interroger vos données. Pour en savoir plus, consultez Connecter votre IDE à AlloyDB à l'aide de la boîte à outils MCP.