Crea un database AlloyDB utilizzando MCP Toolbox nell'IDE

Questa pagina descrive come utilizzare MCP Toolbox for Databases per creare e gestire i cluster e le istanze AlloyDB per PostgreSQL dagli ambienti di sviluppo integrati (IDE). Puoi utilizzare strumenti per sviluppatori che supportano il Model Context Protocol (MCP).

Il Model Context Protocol (MCP) è un protocollo aperto per connettere modelli linguistici di grandi dimensioni (LLM) a origini dati e API come l'API AlloyDB Admin. Un assistente AI è un'interfaccia di chat basata su LLM nel tuo IDE che ti aiuta a raggiungere i tuoi obiettivi e completare le attività. Questa pagina descrive come utilizzare MCP Toolbox for Databases per esporre gli strumenti di assistenza per sviluppatori a un'istanza AlloyDB utilizzando i seguenti IDE:

Prima di iniziare

  1. Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un Google Cloud progetto.

  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud . Scopri come verificare se la fatturazione è abilitata per un progetto.

  3. Abilita l'API AlloyDB Admin.

    Abilita l'API

Ruoli obbligatori

Per gestire le risorse AlloyDB, chiedi all'amministratore di concederti i seguenti ruoli Identity and Access Management nel tuo progetto:

  • Amministratore AlloyDB (roles/alloydb.admin).
  • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

Installare la casella degli strumenti MCP

  1. Scarica l'ultima versione di MCP Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare MCP Toolbox versione V0.10.0 o successive.

    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. Rendi il binario un eseguibile.

    chmod +x toolbox

  3. Verifica l'installazione.

    ./toolbox --version

Configura il client MCP

Puoi configurare il tuo IDE in modo che utilizzi gli strumenti del control plane per creare e gestire cluster e istanze AlloyDB. Se hai già un'istanza AlloyDB, salta questo passaggio e vai a Connetti il tuo IDE ad AlloyDB per PostgreSQL utilizzando MCP Toolbox. Le istanze vengono create con un indirizzo IP pubblico utilizzando gli strumenti del control plane forniti. Aggiungi la seguente configurazione al file delle impostazioni MCP dell'IDE. Questo approccio espone lo strumento alloydb-postgres-admin al tuo assistente AI.

Codice Claude

  1. Installa Claude Code.
  2. Crea un file .mcp.json nella radice del progetto, se non esiste.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.
  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e salva.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude desktop

  1. Apri Claude Desktop e vai a Impostazioni.
  2. Nella scheda Sviluppatore, fai clic su Modifica configurazione per aprire il file di configurazione.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.

  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e salva.

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

Cline

  1. Apri l'estensione Cline in VS Code e tocca l'icona Server MCP.
  2. Tocca Configura server MCP per aprire il file di configurazione.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.

  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e salva.

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

Cursore

  1. Crea la directory .cursor nella radice del progetto, se non esiste.
  2. Crea il file .cursor/mcp.json se non esiste e aprilo.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.
  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e salva:

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

Visual Studio Code (Copilot)

  1. Apri VS Code e crea una directory .vscode nella radice del progetto, se non esiste.
  2. Crea il file .vscode/mcp.json se non esiste e aprilo.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.
  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e salva.

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

Windsurf

  1. Apri Windsurf e vai all'assistente Cascade.
  2. Fai clic sull'icona di MCP, quindi su Configura per aprire il file di configurazione.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.

  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e salva.

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

Interfaccia a riga di comando Gemini

  1. Installa la Gemini CLI.
  2. Nella directory di lavoro, crea una cartella denominata .gemini. Al suo interno, crea un file settings.json.
  3. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.

  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e poi salva.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

  1. Installa l'estensione Gemini Code Assist in Visual Studio Code.
  2. Attiva la modalità Agente nella chat di Gemini Code Assist.
  3. Nella directory di lavoro, crea una cartella denominata .gemini. Al suo interno, crea un file settings.json.
  4. Genera un token di accesso da utilizzare come API_KEY eseguendo gcloud auth print-access-token.

  1. Aggiungi la seguente configurazione, sostituisci API_KEY con il token generato e poi salva:

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

Il tuo strumento di AI è ora connesso al control plane di AlloyDB per PostgreSQL utilizzando MCP. Chiedi all'assistente AI di creare un cluster o un'istanza.

Utilizzare gli strumenti di amministrazione

Sono disponibili i seguenti strumenti per il LLM:

  • alloydb-create-cluster: crea un cluster AlloyDB.
  • alloydb-create-instance: crea un'istanza AlloyDB (PRIMARY, READ_POOL o SECONDARY).
  • alloydb-get-operation: esegue il polling dell'API Operations finché l'operazione non è terminata.

Connettersi ai dati

Dopo aver configurato un cluster e un'istanza AlloyDB, puoi connettere il tuo IDE al database per eseguire query sui tuoi dati. Per ulteriori informazioni, consulta Connettere l'IDE ad AlloyDB utilizzando MCP Toolbox.