Lokalen MCP-Server für Backup und DR verwenden, um Sicherungsvorgänge mit Prompts in natürlicher Sprache zu ermöglichen

Der lokale MCP-Server (Model Context Protocol) für Backup and DR ermöglicht es KI-Assistenten und LLM-basierten Anwendungen, sicher mit Ihrer Sicherungsumgebung zu interagieren. Wenn Sie den Server lokal ausführen, können Sie generative KI verwenden, um Backup und DR-Aufgaben wie das Erstellen von Backup Vaults und Sicherungsplänen oder das Aktivieren von Benachrichtigungen über natürliche Sprachaufforderungen zu verwalten und gleichzeitig die Kontrolle über Ihre lokale Umgebung zu behalten. Weitere Informationen zur Verwendung von MCP-Servern für die Interaktion zwischen Google Cloud Diensten

Der lokale MCP-Server für Backup and DR fungiert als Brücke zwischen einem MCP-kompatiblen Host (z. B. Gemini CLI, ChatGPT oder Claude Code) und der Google Cloud Backup and DR API.

Da der Server auf Ihrer Workstation ausgeführt wird, kann die KI Ihre lokalen Anmeldedaten und den Netzwerkpfad verwenden, um direkt mit Google Cloudzu kommunizieren.

Der lokale MCP-Server für Backup and DR bietet folgende Vorteile:

  • KI-gestützte Verwaltung: Mit Prompts in natürlicher Sprache lassen sich komplexe Backup- und DR-Aufgaben automatisieren und vereinfachen.
  • Sicherheit: Ihre Daten bleiben innerhalb der von Ihnen festgelegten Grenzen. Der lokale Server verwendet Ihre vorhandene Google Cloud CLI-Authentifizierung.
  • Vereinfachte Fehlerbehebung: Nutzer werden über Fehler bei Sicherungs- und Wiederherstellungsjobs informiert und erhalten Schritte zur Fehlerbehebung.
  • Zentrale Suche: Sie können über dieselbe MCP-Umgebung mit mehreren Google Cloud Diensten wie Cloud Monitoring, Cloud Storage und BigQuery interagieren.

Hinweis

Bevor Sie den lokalen MCP-Server für Backup and DR einrichten, benötigen Sie Folgendes:

  • Ein Google Cloud-Projekt, in dem die APIs für Backup and DR, Compute Engine und Cloud SQL aktiviert sind.
  • Ein MCP-Host, z. B. die Gemini CLI.
  • Eine lokale Umgebung mit Folgendem:
    • Node.js (Version 20 oder höher)
    • Das Google Cloud SDK (Google Cloud CLI) muss initialisiert und authentifiziert sein.

Erforderliche Berechtigungen

Nutzer benötigen die entsprechenden IAM-Rollen (Identity and Access Management) und ‑Berechtigungen, um die entsprechenden Aufgaben mit dem lokalen MCP-Server auszuführen. Beispiel:

  • roles/backupdr.viewer (zum Abfragen von Metadateninformationen und ‑status)
  • roles/backupdr.restoreUser (zum Auslösen von Wiederherstellungen)

Lokalen MCP-Server einrichten

So installieren Sie die Gemini CLI und richten den lokalen MCP-Server für Backup und DR ein:

  1. Gemini CLI installieren

    Wenn Sie den lokalen MCP-Server für Backup und DR in die Gemini CLI oder Gemini Code Assist einbinden möchten, führen Sie diesen Einrichtungsbefehl aus. Dadurch wird der MCP-Server als Gemini CLI-Erweiterung für den aktuellen Nutzer installiert und ist für alle Ihre Projekte verfügbar.

    npm install -g @google/gemini-cli
    

    Weitere Informationen finden Sie unter https://geminicli.com/docs/get-started/installation.

  2. Lokalen MCP-Server für Backup und DR einrichten

    Führen Sie diesen Befehl aus, um den Backup and DR MCP-Server zu installieren. Standardmäßig wird der Server auf der Zugriffsebene READ_ONLY installiert.

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

    Nach der Installation können Sie mit dem folgenden Befehl prüfen, ob der Backup and DR-MCP-Server richtig konfiguriert ist:

    gemini mcp list
    

    Die Ausgabe sollte einen Status ähnlich dem folgenden anzeigen:

    > ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - Connected
    
  3. Lokalen MCP-Server konfigurieren

    Sie können das Verhalten des MCP-Servers mit den folgenden Flags anpassen.

    1. Konfigurieren Sie die Zugriffsebene.

      Die Zugriffsebene bestimmt, welche Tools dem KI‑Agenten zur Verfügung stehen.

      • Flag: --access-level
      • Werte: READ_ONLY (Standard), UPSERT, ALL

      • READ_ONLY: Bietet schreibgeschützte Tools für die Suche und Prüfung.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLY
        
      • UPSERT: Bietet Tools zum Auffinden, Prüfen, Erstellen und Aktualisieren (einschließlich Wiederherstellungen).

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERT
        
      • ALLE: Bietet alle Tools, einschließlich destruktiver Vorgänge wie das Löschen.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
        
    2. Kontextdatei konfigurieren

    Kontextdateien sind eine leistungsstarke Funktion, um dem Gemini-Modell Anweisungskontext bereitzustellen. Der Backup- und DR-MCP-Server enthält einige Kontextinformationen zur Verwendung von Tools und gängigen Workflows.

    • Flag: --overwrite-context-file
    • Werte: true, false (Standard)
    • Standort: ~/.gemini/backupdr-mcp/GEMINI.md

    Standardmäßig wird die Kontextdatei nur erstellt, wenn sie noch nicht vorhanden ist. Führen Sie den folgenden Befehl aus, um den MCP-Server zu installieren und die Kontextdatei zu überschreiben:

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

    Wenn --overwrite-context-file auf „false“ gesetzt ist, wird der Kontext bei der Installation der Erweiterung nur erstellt, wenn er noch nicht im Verzeichnis vorhanden ist.

    Führen Sie den folgenden Befehl aus, um den lokalen MCP-Server zu installieren, ohne die Kontextdatei zu überschreiben:

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

    Weitere Informationen finden Sie unter Kontext mit GEMINI.md-Dateien bereitstellen.

  4. Nutzerauthentifizierung und ‑autorisierung konfigurieren

    Der MCP-Server verwendet Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) für die Ausführung von Vorgängen. IAM-Prüfungen, die für den Backup- und DR-Dienst gelten, werden für das ADC ausgeführt. Weitere Informationen zu Standardanmeldedaten für Anwendungen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.

    1. Führen Sie den folgenden Befehl aus, um Ihre Anmeldedaten zu konfigurieren:

      gcloud auth application-default login
      
    2. Wenn Sie Anmeldedaten für Dienstkonten anstelle Ihrer eigenen verwenden möchten, übernehmen Sie die Identität eines Dienstkontos mithilfe von Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC). Führen Sie den folgenden Befehl aus, um die Identität eines Dienstkontos anzunehmen:

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

Verfügbare Tools

Der lokale MCP-Server für Backup und DR umfasst die folgenden Tools.

Schreibgeschützte Tools

Mit diesen Tools können Backup and DR-Ressourcen erkannt und geprüft werden, ohne dass Änderungen möglich sind.

Tool Beschreibung
list_backup_vaults Listet alle Backup-Tresore in einem Projekt und an einem Standort auf.
get_backup_vault Ruft Details zu einem bestimmten Backup Vault ab.
list_backup_plans Listet alle Sicherungspläne in einem Projekt und an einem Standort auf.
get_backup_plan Ruft Details zu einem bestimmten Sicherungsplan ab.
list_backup_plan_associations Listet alle Verknüpfungen zwischen Sicherungsplänen und Ressourcen auf.
get_backup_plan_association Ruft Details zu einer bestimmten Verknüpfung eines Sicherungsplans ab.
list_datasources Listet alle Datenquellen in einem Backup Vault auf.
get_datasource Ruft Details zu einer bestimmten Datenquelle ab.
list_backups Listet alle Sicherungen für eine bestimmte Datenquelle auf.
get_backup Ruft Details zu einer bestimmten Sicherung ab.
find_protectable_resources Ermittelt Ressourcen (VMs, Laufwerke, SQL), die geschützt werden können.
get_backupdr_operation Ruft den Status eines Vorgangs mit langer Ausführungszeit für Backup and DR ab.
get_csql_operation Ruft den Status eines lange andauernden Cloud SQL-Vorgangs ab.

Upsert-Tools

Mit diesen Tools können Ressourcen erstellt und aktualisiert werden, einschließlich Wiederherstellungsvorgängen.

Tool Beschreibung
create_backup_vault Erstellt einen neuen Backup Vault an einem angegebenen Speicherort.
create_backup_plan Erstellt einen neuen Sicherungsplan mit Regeln und Aufbewahrung.
update_backup_plan Ändert einen vorhandenen Sicherungsplan.
create_backup_plan_association Ordnet einer Ressource einen Sicherungsplan zu.
restore_backup Stellt eine Sicherung auf einer Ziel-Compute Engine-Instanz oder ‑Festplatte wieder her.
csql_restore Stellt eine Cloud SQL-Sicherung auf einer Zielinstanz wieder her.

Tools löschen

Mit diesen Tools können Sie unter anderem Ressourcen löschen. Aktivieren Sie sie nur bei Bedarf, indem Sie die Zugriffsebene auf ALL setzen.

Tool Beschreibung
delete_backup_vault Löscht einen Backup Vault.
delete_backup_plan Löscht einen Sicherungsplan.
delete_backup_plan_association Entfernt den Schutz einer Ressource.
delete_backup Löscht eine bestimmte Sicherung aus einem Vault.

Prompt-Beispiele

Sobald der Server verbunden ist, können Sie in Ihrem KI-Client Prompts in natürlicher Sprache verwenden, um Ihre Sicherungsumgebung zu verwalten.

  • Back‑up-Status für ein Projekt bewerten

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die Projekt-ID, in der Sie den Sicherungsstatus prüfen möchten.
    • LOCATION: Die Region, in der sich Ihre Ressourcen befinden.
  • Backup Vault und Sicherungsplan erstellen

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

    Ersetzen Sie Folgendes:

    • VAULT_NAME: Der Name des neuen Sicherungstresors.
    • LOCATION: Die Region, in der Sie den Tresor erstellen möchten.
    • RESOURCE_NAME: Der Name der zu schützenden Ressource.
    • PLAN_NAME: Der Name des Sicherungsplans, der angewendet werden soll.
  • Sicherungen auf Compliance prüfen

    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.
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die Projekt-ID, die geprüft werden soll.
    • LOCATION: Die zu prüfende Region.
  • Ursachenanalyse für Fehler

    Für diesen Prompt ist das Tool observability erforderlich. Informationen zur Installation dieses MCP-Tools finden Sie auf GitHub unter Available MCP Tools.

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

    Ersetzen Sie Folgendes:

    • RESOURCE_NAME: Der Name der Ressource mit Sicherungsfehlern.
    • DURATION: Der Zeitraum für die Untersuchung (z. B. 7).
    • PROJECT_ID: Die Projekt-ID, in der der Fehler aufgetreten ist.
  • Sicherung wiederherstellen

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

    Ersetzen Sie Folgendes:

    • RESOURCE_NAME: Der Name der Ressource, die wiederhergestellt werden soll.
    • PROJECT_ID: Die Projekt-ID, die die Sicherung enthält.
    • NEW_INSTANCE_NAME: Ein Name für die wiederhergestellte Instanz.
  • Benachrichtigungsrichtlinie erstellen

    Sie können Benachrichtigungen für jede beliebige Kombination aus Logs und hinzugefügten Filtern aktivieren.

    Für diesen Prompt ist das Tool gcloud erforderlich. Informationen zur Installation dieses MCP-Tools finden Sie auf GitHub unter Available MCP Tools.

    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.
    

    Ersetzen Sie Folgendes:

    • ALERT_NAME: Ein Name für die neue Benachrichtigungsrichtlinie.
    • EMAIL_ADDRESS: Die E-Mail-Adresse, an die Benachrichtigungen gesendet werden sollen.

Mit anderen KI-Clients auf den Server zugreifen

Sie können den Backup and DR MCP-Server mit anderen Clients verwenden.

  • Fügen Sie dazu den jeweiligen JSON-Konfigurationsdateien das folgende Snippet hinzu:

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

Anleitungen für beliebte Tools:

  • Claude Desktop: Öffnen Sie Claude > „Settings“ (Einstellungen) > „Developer“ (Entwickler) > „Edit Config“ (Konfiguration bearbeiten) und bearbeiten Sie claude_desktop_config.json.
  • Cline: Klicken Sie auf das Symbol „MCP-Server“ und dann auf „MCP-Server konfigurieren“, um cline_mcp_settings.json zu bearbeiten.
  • Cursor: Bearbeiten Sie .cursor/mcp.json für ein einzelnes Projekt oder ~/.cursor/mcp.json für alle Projekte.
  • Gemini CLI (manuelle Einrichtung): Wenn Sie keine Erweiterungen verwenden, bearbeiten Sie .gemini/settings.json für ein einzelnes Projekt oder ~/.gemini/settings.json für alle Projekte.

  • Bearbeiten Sie für Visual Studio Code die Datei .vscode/mcp.json in Ihrem Arbeitsbereich für ein einzelnes Projekt oder Ihre globale Nutzereinstellungsdatei für alle Projekte:

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

Haftungsausschluss

KI-gestützte Vorgänge werden ständig weiterentwickelt. Wir legen zwar großen Wert auf Genauigkeit, aber Sie sollten sich bewusst sein, dass modellgesteuerte Ausgaben Ungenauigkeiten enthalten können und immer auf Richtigkeit überprüft werden sollten.

Nächste Schritte