Utilizza il server MCP locale di Backup e RE per abilitare le operazioni di backup con prompt in linguaggio naturale

Il server Model Context Protocol (MCP) locale di Backup e DR consente agli assistenti AI e alle applicazioni basate su LLM di interagire in modo sicuro con l'ambiente di backup. Se esegui il server localmente, puoi utilizzare l'AI generativa per gestire le attività di Backup eRER, ad esempio la creazione di vault di backup e piani di backup o l'attivazione delle notifiche di avviso, utilizzando prompt in linguaggio naturale mantenendo il controllo dell'ambiente locale. Scopri di più su come utilizzare i server MCP per interagire tra i Google Cloud servizi.

Il server MCP locale di Backup and RE funge da ponte tra un host compatibile con MCP (come Gemini CLI, ChatGPT o Claude Code) e l'API Google Cloud Backup and DR.

Poiché il server viene eseguito sulla workstation, l'AI può utilizzare le credenziali e il percorso di rete locali per comunicare direttamente con Google Cloud.

Il server MCP locale di Backup e RE offre i seguenti vantaggi:

  • Gestione basata sull'AI: utilizza prompt in linguaggio naturale per automatizzare e semplificare le complesse attività di backup eRER.
  • Sicurezza: i tuoi dati rimangono all'interno dei perimetri definiti. Il server locale utilizza l'autenticazione Google Cloud CLI esistente.
  • Risoluzione dei problemi semplificata: identifica e avvisa gli utenti in caso di errori dei job di backup e ripristino e ricevi i passaggi di correzione per risolvere gli errori.
  • Rilevamento centralizzato: interagisci con più servizi Google Cloud , come Cloud Monitoring, Cloud Storage e BigQuery, utilizzando lo stesso ambiente MCP.

Prima di iniziare

Prima di configurare il server MCP locale per Backup e RE, assicurati di disporre di quanto segue:

  • Un progetto Google Cloud con le API Backup e RE, Compute Engine e Cloud SQL abilitate.
  • Un host MCP, come Gemini CLI.
  • Un ambiente locale con quanto segue:
    • Node.js (v20+)
    • Google Cloud SDK (Google Cloud CLI) inizializzato e autenticato.

Autorizzazioni obbligatorie

Gli utenti hanno bisogno di ruoli e autorizzazioni Identity and Access Management (IAM) pertinenti per eseguire le attività corrispondenti utilizzando il server MCP locale. Ad esempio:

  • roles/backupdr.viewer (per eseguire query sullo stato e sulle informazioni dei metadati)
  • roles/backupdr.restoreUser (per attivare i ripristini)

Configurare il server MCP locale

Per installare Gemini CLI e configurare il server MCP locale di Backup e RE, segui questi passaggi:

  1. Installa Gemini CLI

    Per integrare il server MCP locale di Backup e RE con Gemini CLI o Gemini Code Assist, esegui questo comando di configurazione. In questo modo, il server MCP verrà installato come estensione di Gemini CLI per l'utente corrente, rendendolo disponibile per tutti i tuoi progetti.

    npm install -g @google/gemini-cli
    

    Per saperne di più, visita la pagina https://geminicli.com/docs/get-started/installation.

  2. Configura il server MCP locale di Backup e RE

    Per installare il server MCP di Backup e DR, esegui questo comando. Per impostazione predefinita, il server viene installato con il livello di accesso READ_ONLY.

    npx @google-cloud/backupdr-mcp init --agent=gemini-cli
    

    Al termine della procedura di installazione, puoi verificare che il server MCP di Backup e RE sia configurato correttamente eseguendo il seguente comando:

    gemini mcp list
    

    L'output dovrebbe mostrare uno stato simile al seguente:

    > ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - Connected
    
  3. Configura il server MCP locale

    Puoi personalizzare il comportamento del server MCP utilizzando i seguenti flag.

    1. Configura il livello di accesso.

      Il livello di accesso controlla quali strumenti sono disponibili per l'agente AI.

      • Bandiera: --access-level
      • Valori: READ_ONLY (predefinito), UPSERT, ALL

      • READ_ONLY: fornisce strumenti di sola lettura per l'individuazione e l'ispezione.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLY
        
      • UPSERT: fornisce strumenti di rilevamento, ispezione, creazione e aggiornamento (inclusi i ripristini).

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERT
        
      • ALL: fornisce tutti gli strumenti, incluse le operazioni distruttive come l'eliminazione.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
        
    2. Configurare il file di contesto

    I file di contesto sono una funzionalità potente per fornire un contesto didattico al modello Gemini. Il server MCP di Backup e DR include alcune informazioni contestuali su come utilizzare gli strumenti e i flussi di lavoro comuni.

    • Bandiera: --overwrite-context-file
    • Valori: true, false (valore predefinito)
    • Località: ~/.gemini/backupdr-mcp/GEMINI.md

    Per impostazione predefinita, il file di contesto viene creato solo se non esiste già. Per installare il server MCP sovrascrivendo il file di contesto, esegui il seguente comando:

    npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=true
    

    Se --overwrite-context-file è impostato su false, durante l'installazione dell'estensione il contesto verrà creato solo se non esiste già nella directory.

    Per installare il server MCP locale senza sovrascrivere il file di contesto, esegui questo comando:

    npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=false
    

    Per maggiori dettagli, vedi Fornire contesto con i file GEMINI.md.

  4. Configura l'autenticazione e l'autorizzazione degli utenti

    Il server MCP utilizza le Credenziali predefinite dell'applicazione (ADC) per eseguire le operazioni. I controlli IAM applicabili al servizio di Backup e DR vengono eseguiti sul controller di distribuzione delle applicazioni. Per ulteriori informazioni sulle credenziali predefinite dell'applicazione, consulta Configurare le credenziali predefinite dell'applicazione.

    1. Per configurare le credenziali, esegui questo comando:

      gcloud auth application-default login
      
    2. Per utilizzare le credenziali del account di servizio anziché le tue, simula un account di servizio utilizzando le Credenziali predefinite dell'applicazione (ADC). Esegui questo comando per rappresentare un account di servizio:

      gcloud auth application-default login --impersonate-service-account [SERVICE_ACCOUNT_EMAIL]
      

Strumenti disponibili

Il server MCP locale di Backup e RE include i seguenti strumenti.

Strumenti di sola lettura

Questi strumenti consentono di rilevare e ispezionare le risorse di Backup e RE senza consentire modifiche.

Strumento Descrizione
list_backup_vaults Elenca tutti i vault di backup in un progetto e una località.
get_backup_vault Recupera i dettagli di un vault di backup specifico.
list_backup_plans Elenca tutti i piani di backup in un progetto e una località.
get_backup_plan Recupera i dettagli di un piano di backup specifico.
list_backup_plan_associations Elenca tutte le associazioni tra i piani di backup e le risorse.
get_backup_plan_association Recupera i dettagli di un'associazione di piani di backup specifica.
list_datasources Elenca tutte le origini dati all'interno di un vault di backup.
get_datasource Recupera i dettagli di un'origine dati specifica.
list_backups Elenca tutti i backup per una determinata origine dati.
get_backup Recupera i dettagli di un backup specifico.
find_protectable_resources Rileva le risorse (VM, dischi, SQL) che possono essere protette.
get_backupdr_operation Recupera lo stato di un'operazione di Backup e RE a lunga esecuzione.
get_csql_operation Recupera lo stato di un'operazione Cloud SQL a lunga esecuzione.

Strumenti di upsert

Questi strumenti consentono di creare e aggiornare le risorse, incluse le operazioni di ripristino.

Strumento Descrizione
create_backup_vault Crea un nuovo vault di backup in una posizione specificata.
create_backup_plan Crea un nuovo piano di backup con regole e conservazione.
update_backup_plan Modifica un piano di backup esistente.
create_backup_plan_association Associa una risorsa a un piano di backup.
restore_backup Ripristina un backup in un'istanza o un disco Compute Engine di destinazione.
csql_restore Ripristina un backup Cloud SQL in un'istanza di destinazione.

Elimina strumenti

Questi strumenti includono la possibilità di eliminare le risorse. Attivali solo quando necessario impostando il livello di accesso su ALL.

Strumento Descrizione
delete_backup_vault Elimina un vault di backup.
delete_backup_plan Elimina un piano di backup.
delete_backup_plan_association Rimuove la protezione da una risorsa.
delete_backup Elimina un backup specifico da un vault.

Prompt di esempio

Una volta connesso il server, puoi utilizzare prompt in linguaggio naturale nel client AI per gestire l'ambiente di backup.

  • Valutare lo stato del backup in un progetto

    Show the list of unprotected resources in project PROJECT_ID for region LOCATION.
    

    Sostituisci quanto segue:

    • PROJECT_ID: L'ID progetto in cui vuoi controllare lo stato di integrità del backup.
    • LOCATION: la regione in cui si trovano le risorse.
  • Crea un vault di backup e un piano di backup

    Create a backup vault named VAULT_NAME in LOCATION to protect resource RESOURCE_NAME using backup plan PLAN_NAME.
    

    Sostituisci quanto segue:

    • VAULT_NAME: il nome del nuovo vault di backup.
    • LOCATION: la regione in cui vuoi creare il vault.
    • RESOURCE_NAME: il nome della risorsa da proteggere.
    • PLAN_NAME: il nome del piano di backup da applicare.
  • Eseguire audit dei backup per la conformità

    Audit all backups in the project PROJECT_ID in the region LOCATION. Once the audit is complete, compare the findings against my corporate backup policy to identify any compliance gaps.
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto da controllare.
    • LOCATION: la regione da controllare.
  • Analisi delle cause principali degli errori

    Questo prompt richiede lo strumento observability. Per installare questo strumento MCP, consulta la sezione Available MCP Tools su GitHub.

    Identify and investigate the root cause of the resource RESOURCE_NAME backup failure in the last DURATION days in project PROJECT_ID.
    

    Sostituisci quanto segue:

    • RESOURCE_NAME: il nome della risorsa con errori di backup.
    • DURATION: la finestra temporale per l'indagine (ad esempio, 7).
    • PROJECT_ID: l'ID progetto in cui si è verificato l'errore.
  • Ripristinare un backup

    Restore the last successful backup for resource RESOURCE_NAME from project PROJECT_ID. Name the restored instance NEW_INSTANCE_NAME.
    

    Sostituisci quanto segue:

    • RESOURCE_NAME: il nome della risorsa da ripristinare.
    • PROJECT_ID: l'ID progetto contenente il backup.
    • NEW_INSTANCE_NAME: un nome per l'istanza ripristinata.
  • Crea un criterio di avviso

    Puoi attivare gli avvisi per qualsiasi combinazione di log e filtri aggiunti.

    Questo prompt richiede lo strumento gcloud. Per installare questo strumento MCP, consulta la sezione Available MCP Tools su GitHub.

    Create a log-based alert policy named ALERT_NAME to trigger on any log entry from `backupdr.googleapis.com` with severity `ERROR`. Send notification of the alerts immediately to EMAIL_ADDRESS.
    

    Sostituisci quanto segue:

    • ALERT_NAME: un nome per la nuova policy di avviso.
    • EMAIL_ADDRESS: l'email a cui ricevere le notifiche.

Accedere al server utilizzando altri client AI

Puoi utilizzare il server Backup e DR MCP con altri client.

  • Per farlo, aggiungi il seguente snippet ai rispettivi file di configurazione JSON:

    "backupdr": {
      "command": "npx",
      "args": ["-y", "@google-cloud/backupdr-mcp"]
    }
    

Istruzioni per gli strumenti più diffusi:

  • Claude Desktop: apri Claude > Impostazioni > Sviluppatore > Modifica configurazione e modifica claude_desktop_config.json.
  • Cline: fai clic sull'icona Server MCP, poi su Configura server MCP per modificare cline_mcp_settings.json.
  • Cursore: modifica .cursor/mcp.json per un singolo progetto o ~/.cursor/mcp.json per tutti i progetti.
  • Gemini CLI (configurazione manuale): se non utilizzi le estensioni, modifica .gemini/settings.json per un singolo progetto o ~/.gemini/settings.json per tutti i progetti.

  • Per Visual Studio Code, modifica il file .vscode/mcp.json nello spazio di lavoro per un singolo progetto o il file delle impostazioni utente globali per tutti i progetti:

    "servers": {
      "backupdr": {
        "command": "npx",
        "args": ["-y", "@google-cloud/backupdr-mcp"]
      }
    }
    

Limitazione di responsabilità

Le operazioni assistite dall'AI sono ancora in fase di evoluzione. Anche se diamo la priorità all'accuratezza, tieni presente che gli output basati su modelli possono includere imprecisioni e devono sempre essere esaminati per verificarne la correttezza.

Passaggi successivi