Lokalen MCP-Server von Backup and DR verwenden

Der lokale MCP-Server (Model Context Protocol) für Backup und 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 Aufgaben für Backup und DR zu verwalten, z. B. Backup Vaults und Sicherungspläne zu erstellen oder Benachrichtigungen zu aktivieren. Dazu verwenden Sie Prompts in natürlicher Sprache und behalten die Kontrolle über Ihre lokale Umgebung. Weitere Informationen zur Verwendung von MCP-Servern für die Interaktion zwischen Google Cloud Diensten.

Der lokale MCP-Server für Sicherung und Notfallwiederherstellung 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 und DR bietet folgende Vorteile:

  • Backup und DR mit KI: Verwenden Sie Prompts in natürlicher Sprache, um komplexe Aufgaben für Backup und DR zu automatisieren und zu vereinfachen.
  • Sicherheit: Ihre Daten bleiben innerhalb Ihrer definierten Perimeter. Der lokale Server verwendet Ihre vorhandene gcloud CLI Authentifizierung.
  • Vereinfachte Fehlerbehebung: Sie können Nutzer über Fehler bei Sicherungs- und Wiederherstellungsjobs informieren und Schritte zur Fehlerbehebung erhalten.
  • Zentrale Erkennung: Sie können mit derselben 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 und DR einrichten, müssen Sie Folgendes erledigt haben:

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

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 Metadaten 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

    Führen Sie diesen Einrichtungsbefehl aus, um den lokalen MCP-Server für Backup und DR in die Gemini CLI oder Gemini Code Assist zu integrieren. 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 und DR MCP-Server zu installieren. Standardmäßig wird der Server mit 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 und DR MCP-Server richtig konfiguriert ist:

    gemini mcp list

    Die Ausgabe sollte einen Status ähnlich dem folgenden zeigen:

    > ✓ 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. Zugriffsebene konfigurieren

      Die Zugriffsebene steuert, 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 Erkennung und Überprüfung.

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

      • UPSERT: Bietet Tools für Erkennung, Überprüfung, Erstellung und Aktualisierung (einschließlich Wiederherstellungen).

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

      • ALL: 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ängiger Workflows.

    • Flag: --overwrite-context-file
    • Werte: true, false (Standard)
    • Speicherort: ~/.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), um Vorgänge auszuführen. IAM-Prüfungen, die für Backup und DR gelten, werden für die ADC durchgefü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, imitieren Sie ein Dienstkonto mit Standardanmeldedaten für Anwendungen (ADC). Führen Sie den folgenden Befehl aus, um ein Dienstkonto zu imitieren:

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

Verfügbare Tools

Der lokale MCP-Server für Backup und DR enthält die folgenden Tools.

Schreibgeschützte Tools

Mit diesen Tools können Sie Ressourcen für Backup und DR erkennen und überprüfen, ohne Änderungen vorzunehmen.

Tool Beschreibung
list_backup_vaults Listet alle Backup Vaults 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 lange andauernden Vorgangs für Backup und DR ab.
get_csql_operation Ruft den Status eines lange andauernden Cloud SQL-Vorgangs ab.

Upsert-Tools

Mit diesen Tools können Sie Ressourcen erstellen und aktualisieren, einschließlich Wiederherstellungsvorgängen.

Tool Beschreibung
create_backup_vault Erstellt einen neuen Backup Vault an einem angegebenen Standort.
create_backup_plan Erstellt einen neuen Sicherungsplan mit Regeln und Aufbewahrung.
update_backup_plan Ändert einen vorhandenen Sicherungsplan.
create_backup_plan_association Verknüpft eine Ressource mit einem Sicherungsplan.
restore_backup Stellt eine Sicherung auf einer Compute Engine-Zielinstanz oder einem Ziellaufwerk wieder her.
csql_restore Stellt eine Cloud SQL-Sicherung auf einer Zielinstanz wieder her.

Tools zum Löschen

Mit diesen Tools können Sie 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 von 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.

  • Sicherungsstatus für ein Projekt bewerten

    „Zeige die Liste der ungeschützten Ressourcen im Projekt PROJECT_ID für die Region LOCATION.“

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die Projekt-ID, für die Sie den Sicherungsstatus prüfen möchten.
    • LOCATION: Die Region, in der sich Ihre Ressourcen befinden.

  • Backup Vault und Sicherungsplan erstellen

    „Erstelle einen Backup Vault mit dem Namen VAULT_NAME in LOCATION, um die Ressource RESOURCE_NAME mit dem Sicherungsplan PLAN_NAME zu schützen.“

    Ersetzen Sie Folgendes:

    • VAULT_NAME: Der Name des neuen Backup Vaults.
    • LOCATION: Die Region, in der Sie den Vault erstellen möchten.
    • RESOURCE_NAME: Der Name der zu schützenden Ressource.
    • PLAN_NAME: Der Name des anzuwendenden Sicherungsplans.

  • Sicherungen auf Compliance prüfen

    „Prüfe alle Sicherungen im Projekt PROJECT_ID in der Region LOCATION. Vergleiche nach Abschluss der Prüfung die Ergebnisse mit meiner Unternehmensrichtlinie für Sicherungen, um Compliance-Lücken zu ermitteln.“

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die Projekt-ID, die geprüft werden soll.
    • LOCATION: Die Region, die geprüft werden soll.

  • Ursachenanalyse für Fehler

    Für diesen Prompt ist das Tool observability erforderlich. Informationen zum Installieren dieses MCP-Tools finden Sie unter Verfügbare MCP-Tools auf GitHub.

    „Ermittle und untersuche die Ursache des Fehlers bei der Sicherung der Ressource RESOURCE_NAME in den letzten DURATION Tagen im Projekt 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

    „Stelle die letzte erfolgreiche Sicherung für die Ressource RESOURCE_NAME aus dem Projekt PROJECT_ID wieder her. Gib der wiederhergestellten Instanz den Namen NEW_INSTANCE_NAME."

    Ersetzen Sie Folgendes:

    • RESOURCE_NAME: Der Name der wiederherzustellenden Ressource.
    • 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 Kombination aus Logs und hinzugefügten Filtern aktivieren.

    Für diesen Prompt ist das Tool gcloud erforderlich. Informationen zum Installieren dieses MCP-Tools finden Sie unter Verfügbare MCP-Tools auf GitHub.

    „Erstelle eine logbasierte Benachrichtigungsrichtlinie mit dem Namen ALERT_NAME, die bei jedem Logeintrag von backupdr.googleapis.com mit dem Schweregrad ERROR ausgelöst wird. Sende Benachrichtigungen sofort an 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 und DR MCP-Server mit anderen Clients verwenden.

  • Fügen Sie dazu den folgenden Code-Snippet den entsprechenden JSON-Konfigurationsdateien hinzu:

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

Anleitung für beliebte Tools:

  • Claude Desktop: Öffnen Sie Claude > Einstellungen > Entwickler > Konfiguration bearbeiten und bearbeiten Sie claude_desktop_config.json.
  • Cline: Klicken Sie auf das Symbol für 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 die globale Datei mit den Nutzereinstellungen 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 Wert auf Genauigkeit, aber Sie sollten sich bewusst sein, dass modellgesteuerte Ausgaben Ungenauigkeiten enthalten können und immer auf Richtigkeit überprüft werden müssen.

Nächste Schritte