Utilizza il server MCP locale di Backup e RE

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 il tuo ambiente di backup. Eseguendo il server in locale, puoi utilizzare l'AI generativa per gestire le attività di Backup e RE, ad esempio creare vault di backup e piani di backup o abilitare le notifiche di avviso, utilizzando prompt in linguaggio naturale, mantenendo il controllo sull'ambiente locale. Scopri di più su come utilizzare i server MCP per interagire tra i Google Cloud servizi.

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

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

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

  • Gestione basata sull'AI: utilizza i prompt in linguaggio naturale per automatizzare e semplificare le attività complesse di Backup e RE.
  • Sicurezza: i tuoi dati rimangono all'interno dei perimetri definiti. Il server locale utilizza l'autenticazione gcloud CLI esistente.
  • Risoluzione dei problemi semplificata: identifica e avvisa gli utenti in caso di errori dei job di backup e ripristino e segui i passaggi di correzione per risolvere gli errori.
  • Rilevamento centralizzato: interagisci con più Google Cloud servizi, 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 avere quanto segue:

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

Autorizzazioni obbligatorie

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

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

Configura 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 maggiori informazioni, visita 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 del processo di installazione, puoi verificare che il server MCP di Backup e RE sia configurato correttamente eseguendo il comando seguente:

    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 gli strumenti disponibili per l'agente AI.

      • Flag: --access-level

      • Valori: READ_ONLY (valore predefinito), UPSERT, ALL

      • READ_ONLY: fornisce strumenti di sola lettura per il rilevamento 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 ripristinati).

        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. Configura 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 di contesto su come utilizzare gli strumenti e i workflow comuni.

    • Flag: --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 comando seguente:

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

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

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

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

    Per maggiori dettagli, vedi Fornire il 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 a Backup e RE vengono eseguiti sulle ADC. Per maggiori informazioni sulle credenziali predefinite dell'applicazione, vedi Configura le credenziali predefinite dell'applicazione.

    1. Per configurare le credenziali, esegui il comando seguente:

      gcloud auth application-default login

    2. Per utilizzare le credenziali dell'account di servizio anziché le tue, simula l'identità di un account di servizio utilizzando le Credenziali predefinite dell'applicazione (ADC). Esegui il comando seguente per simulare l'identità di 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 piani di backup e 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 un'origine dati specifica.
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 di 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 località 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 di Compute Engine di destinazione.
csql_restore Ripristina un backup di Cloud SQL in un'istanza target.

Strumenti di eliminazione

Questi strumenti includono la possibilità di eliminare le risorse. Abilitali 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 i prompt in linguaggio naturale nel client AI per gestire l'ambiente di backup.

  • Valuta lo stato del backup in un progetto

    "Mostra l'elenco delle risorse non protette nel progetto PROJECT_ID per la regione LOCATION."

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto in cui vuoi controllare lo stato del backup.
    • LOCATION: la regione in cui si trovano le risorse.

  • Crea un vault di backup e un piano di backup

    "Crea un vault di backup denominato VAULT_NAME in LOCATION per proteggere la risorsa RESOURCE_NAME utilizzando il piano di backup 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.

  • Esegui l'audit dei backup per la conformità

    "Esegui l'audit di tutti i backup nel progetto PROJECT_ID nella regione LOCATION. Al termine dell'audit, confronta i risultati con la mia policy di backup aziendale per identificare eventuali lacune di conformità."

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto di cui eseguire l'audit.
    • LOCATION: la regione di cui eseguire l'audit.

  • Analisi delle cause principali per gli errori

    Questo prompt richiede lo strumento observability. Per installare questo strumento MCP, vedi Strumenti MCP disponibili su GitHub.

    "Identifica e analizza la causa principale dell'errore di backup della risorsa RESOURCE_NAME negli ultimi DURATION giorni nel progetto 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.

  • Ripristina un backup

    "Ripristina l'ultimo backup riuscito per la risorsa RESOURCE_NAME dal progetto PROJECT_ID. Assegna il nome NEW_INSTANCE_NAME all'istanza ripristinata."

    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 abilitare gli avvisi per qualsiasi combinazione di log e filtri aggiunti.

    Questo prompt richiede lo strumento gcloud. Per installare questo strumento MCP, vedi Strumenti MCP disponibili su GitHub.

    "Crea un criterio di avviso basato su log denominato ALERT_NAME da attivare per qualsiasi voce di log di backupdr.googleapis.com con gravità ERROR. Invia immediatamente una notifica degli avvisi a EMAIL_ADDRESS."

    Sostituisci quanto segue:

    • ALERT_NAME: un nome per il nuovo criterio di avviso.
    • EMAIL_ADDRESS: l'indirizzo email a cui ricevere le notifiche.

Accedi al server utilizzando altri client AI

Puoi utilizzare il server MCP di Backup e DR 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, quindi su Configura server MCP per modificare cline_mcp_settings.json.
  • Cursor: 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 nell'area 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"]
  }
}

Disclaimer

Le operazioni assistite dall'AI sono ancora in fase di sviluppo. Sebbene 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