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:
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-cliWeitere Informationen finden Sie unter https://geminicli.com/docs/get-started/installation.
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_ONLYinstalliert.npx @google-cloud/backupdr-mcp init --agent=gemini-cliNach der Installation können Sie mit dem folgenden Befehl prüfen, ob der Backup and DR-MCP-Server richtig konfiguriert ist:
gemini mcp listDie Ausgabe sollte einen Status ähnlich dem folgenden anzeigen:
> ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - ConnectedLokalen MCP-Server konfigurieren
Sie können das Verhalten des MCP-Servers mit den folgenden Flags anpassen.
Konfigurieren Sie die Zugriffsebene.
Die Zugriffsebene bestimmt, welche Tools dem KI‑Agenten zur Verfügung stehen.
- Flag:
--access-level Werte:
READ_ONLY(Standard),UPSERT,ALLREAD_ONLY: Bietet schreibgeschützte Tools für die Suche und Prüfung.
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLYUPSERT: Bietet Tools zum Auffinden, Prüfen, Erstellen und Aktualisieren (einschließlich Wiederherstellungen).
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERTALLE: Bietet alle Tools, einschließlich destruktiver Vorgänge wie das Löschen.
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
- Flag:
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=trueWenn
--overwrite-context-fileauf „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=falseWeitere Informationen finden Sie unter Kontext mit GEMINI.md-Dateien bereitstellen.
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.
Führen Sie den folgenden Befehl aus, um Ihre Anmeldedaten zu konfigurieren:
gcloud auth application-default loginWenn 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
observabilityerforderlich. 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
gclouderforderlich. 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.jsonzu bearbeiten. - Cursor: Bearbeiten Sie
.cursor/mcp.jsonfür ein einzelnes Projekt oder~/.cursor/mcp.jsonfür alle Projekte. Gemini CLI (manuelle Einrichtung): Wenn Sie keine Erweiterungen verwenden, bearbeiten Sie
.gemini/settings.jsonfür ein einzelnes Projekt oder~/.gemini/settings.jsonfür alle Projekte.Bearbeiten Sie für Visual Studio Code die Datei
.vscode/mcp.jsonin 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
- Weitere Informationen zuGoogle Cloud MCP-Servern
- Weitere Informationen finden Sie in der Dokumentation zur Gemini CLI.
- Standardanmeldedaten für Anwendungen