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:
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-cliPer saperne di più, visita la pagina https://geminicli.com/docs/get-started/installation.
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-cliAl termine della procedura di installazione, puoi verificare che il server MCP di Backup e RE sia configurato correttamente eseguendo il seguente comando:
gemini mcp listL'output dovrebbe mostrare uno stato simile al seguente:
> ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - ConnectedConfigura il server MCP locale
Puoi personalizzare il comportamento del server MCP utilizzando i seguenti flag.
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,ALLREAD_ONLY: fornisce strumenti di sola lettura per l'individuazione e l'ispezione.
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLYUPSERT: fornisce strumenti di rilevamento, ispezione, creazione e aggiornamento (inclusi i ripristini).
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERTALL: fornisce tutti gli strumenti, incluse le operazioni distruttive come l'eliminazione.
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
- Bandiera:
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=trueSe
--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=falsePer maggiori dettagli, vedi Fornire contesto con i file GEMINI.md.
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.
Per configurare le credenziali, esegui questo comando:
gcloud auth application-default loginPer 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.jsonper un singolo progetto o~/.cursor/mcp.jsonper tutti i progetti. Gemini CLI (configurazione manuale): se non utilizzi le estensioni, modifica
.gemini/settings.jsonper un singolo progetto o~/.gemini/settings.jsonper tutti i progetti.Per Visual Studio Code, modifica il file
.vscode/mcp.jsonnello 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
- Scopri di più sui server MCP.Google Cloud
- Fai riferimento alla documentazione di Gemini CLI.
- Scopri di più sulle credenziali predefinite dell'applicazione.