使用備份和災難復原本機 MCP 伺服器,透過自然語言提示啟用備份作業

備份和災難復原本機 Model Context Protocol (MCP) 伺服器可讓 AI 助理和大型語言模型 (LLM) 驅動的應用程式,安全地與備份環境互動。在本機執行伺服器時,您可以使用生成式 AI,透過自然語言提示管理備份和災難復原工作 (例如建立備份儲存空間和備份方案,或啟用快訊通知),同時維持對本機環境的控制權。進一步瞭解如何使用 MCP 伺服器跨服務互動 Google Cloud 。

Backup and DR 本機 MCP 伺服器可做為 MCP 相容主機 (例如 Gemini CLI、ChatGPT 或 Claude Code) 與 Google Cloud Backup and DR API 之間的橋梁。

由於伺服器是在工作站上執行,AI 可以使用本機憑證和網路路徑,直接與 Google Cloud通訊。

備份和災難復原本機 MCP 伺服器具有下列優點:

  • AI 驅動的管理:使用自然語言提示詞自動執行及簡化複雜的備份和災難復原工作。
  • 安全性:您的資料會留在您定義的範圍內。本機伺服器會使用現有的 Google Cloud CLI 驗證。
  • 簡化疑難排解程序:找出備份和還原工作失敗的原因,並向使用者發出警示,同時提供修正錯誤的補救步驟。
  • 集中式探索:使用相同的 MCP 環境,與多項 Google Cloud 服務互動,例如 Cloud Monitoring、Cloud Storage 和 BigQuery。

事前準備

為備份和災難復原設定本機 MCP 伺服器前,請確認您具備下列項目:

  • 已啟用備份和災難復原、Compute Engine 和 Cloud SQL API 的 Google Cloud 專案。
  • MCP 主機,例如 Gemini CLI。
  • 具有下列項目的本機環境:
    • Node.js (20 以上版本)
    • 已初始化並驗證 Google Cloud SDK (Google Cloud CLI)。

所需權限

使用者必須具備相關的 Identity and Access Management (IAM) 角色和權限,才能使用本機 MCP 伺服器執行對應工作。例如:

  • roles/backupdr.viewer (查詢中繼資料資訊和狀態)
  • roles/backupdr.restoreUser (觸發還原作業)

設定本機 MCP 伺服器

如要安裝 Gemini CLI 並設定 Backup and DR 本機 MCP 伺服器,請按照下列步驟操作:

  1. 安裝 Gemini CLI

    如要將備份和災難復原本機 MCP 伺服器與 Gemini CLI 或 Gemini Code Assist 整合,請執行這項設定指令。這會將 MCP 伺服器安裝為目前使用者的 Gemini CLI 擴充功能,讓所有專案都能使用。

    npm install -g @google/gemini-cli
    

    詳情請參閱 https://geminicli.com/docs/get-started/installation。

  2. 設定備份和災難復原服務的本機 MCP 伺服器

    如要安裝備份和災難復原 MCP 伺服器,請執行下列指令。根據預設,系統會以 READ_ONLY 存取層級安裝伺服器。

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

    安裝程序完成後,您可以執行下列指令,確認 Backup and DR MCP 伺服器設定正確無誤:

    gemini mcp list
    

    輸出內容應會顯示類似以下的狀態:

    > ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - Connected
    
  3. 設定本機 MCP 伺服器

    您可以使用下列標記自訂 MCP 伺服器行為。

    1. 設定存取層級。

      存取層級會控管 AI 代理程式可用的工具。

      • 旗標:--access-level
      • 值:READ_ONLY (預設)、UPSERT、ALL

      • READ_ONLY:提供唯讀工具,用於探索和檢查。

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLY
        
      • UPSERT:提供探索、檢查、建立和更新工具 (包括還原)。

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERT
        
      • ALL:提供所有工具,包括刪除等破壞性作業。

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
        
    2. 設定結構定義檔案

    脈絡檔案是一項強大的功能,可為 Gemini 模型提供指令脈絡。備份和災難復原 MCP 伺服器隨附一些背景資訊,說明如何使用工具和常見工作流程。

    • 旗標:--overwrite-context-file
    • 值:true、false (預設)
    • 位置:~/.gemini/backupdr-mcp/GEMINI.md

    根據預設,只有在沒有結構定義檔案時,系統才會建立結構定義檔案。如要透過覆寫結構定義檔案安裝 MCP 伺服器,請執行下列指令:

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

    如果 --overwrite-context-file 設為 false,擴充功能安裝時,只有在目錄中沒有內容時,才會建立內容。

    如要安裝本機 MCP 伺服器,但不要覆寫結構定義檔案,請執行下列指令:

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

    詳情請參閱「使用 GEMINI.md 檔案提供脈絡」。

  4. 設定使用者驗證和授權

    MCP 伺服器會使用應用程式預設憑證 (ADC) 執行作業。 系統會在 ADC 上執行適用於備份和災難復原服務的 IAM 檢查。如要進一步瞭解應用程式預設憑證,請參閱「設定應用程式預設憑證」。

    1. 如要設定憑證,請執行下列指令:

      gcloud auth application-default login
      
    2. 如要使用服務帳戶憑證而非自己的憑證,請使用應用程式預設憑證 (ADC) 模擬服務帳戶。執行下列指令,模擬服務帳戶:

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

可用的工具

備份和災難復原本機 MCP 伺服器包含下列工具。

唯讀工具

這些工具可讓您探索及檢查備份和災難復原資源,但無法進行任何編輯。

工具 說明
list_backup_vaults 列出專案和位置中的所有備份保存庫。
get_backup_vault 取得特定備份儲存空間的詳細資料。
list_backup_plans 列出專案和位置中的所有備份方案。
get_backup_plan 取得特定備份方案的詳細資料。
list_backup_plan_associations 列出備份方案與資源之間的所有關聯。
get_backup_plan_association 取得特定備份方案關聯的詳細資料。
list_datasources 列出備份保存庫中的所有資料來源。
get_datasource 取得特定資料來源的詳細資料。
list_backups 列出指定資料來源的所有備份。
get_backup 取得特定備份的詳細資料。
find_protectable_resources 探索可受保護的資源 (VM、磁碟、SQL)。
get_backupdr_operation 擷取長時間執行的備份和災難復原作業狀態。
get_csql_operation 擷取長時間執行的 Cloud SQL 作業狀態。

Upsert tools

這些工具可讓您建立及更新資源,包括還原作業。

工具 說明
create_backup_vault 在指定位置建立新的備份保存庫。
create_backup_plan 建立新的備份方案,並設定規則和保留期限。
update_backup_plan 修改現有的備份方案。
create_backup_plan_association 將資源與備份方案建立關聯。
restore_backup 將備份還原至目標 Compute Engine 執行個體或磁碟。
csql_restore 將 Cloud SQL 備份還原至目標執行個體。

刪除工具

這些工具包括刪除資源的功能。只有在必要時,才將存取層級設為 ALL,啟用這些功能。

工具 說明
delete_backup_vault 刪除備份儲存空間。
delete_backup_plan 刪除備份方案。
delete_backup_plan_association 從資源中移除保護措施。
delete_backup 從備份保存庫中刪除特定備份。

範例提示詞

連線至伺服器後,您可以在 AI 用戶端中使用自然語言提示,管理備份環境。

  • 評估專案的備份健康狀態

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

    更改下列內容:

    • PROJECT_ID:要檢查備份健康狀態的專案 ID。
    • LOCATION:資源所在的區域。
  • 建立備份保存庫和備份方案

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

    更改下列內容:

    • VAULT_NAME:新備份保存庫的名稱。
    • LOCATION:要建立保存庫的區域。
    • RESOURCE_NAME:要保護的資源名稱。
    • PLAN_NAME:要套用的備份方案名稱。
  • 稽核備份資料是否符合法規

    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.
    

    更改下列內容:

    • PROJECT_ID:要稽核的專案 ID。
    • LOCATION:要稽核的區域。
  • 失敗的根本原因分析

    這則提示需要使用 observability 工具。如要安裝這項 MCP 工具,請參閱 GitHub 上的「可用的 MCP 工具」。

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

    更改下列內容:

    • RESOURCE_NAME:備份失敗的資源名稱。
    • DURATION:調查的時間範圍 (例如 7)。
    • PROJECT_ID:發生失敗的專案 ID。
  • 還原備份

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

    更改下列內容:

    • RESOURCE_NAME:要還原的資源名稱。
    • PROJECT_ID:包含備份的專案 ID。
    • NEW_INSTANCE_NAME:還原的執行個體名稱。
  • 建立快訊政策

    您可以為任意組合的記錄和新增篩選器啟用快訊。

    這則提示需要使用 gcloud 工具。如要安裝這項 MCP 工具,請參閱 GitHub 上的「可用的 MCP 工具」。

    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.
    

    更改下列內容:

    • ALERT_NAME:新快訊政策的名稱。
    • EMAIL_ADDRESS:接收通知的電子郵件地址。

使用其他 AI 用戶端存取伺服器

您可以將備份和災難復原 MCP 伺服器與其他用戶端搭配使用。

  • 如要這麼做,請在各自的 JSON 設定檔中新增下列程式碼片段:

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

熱門工具的操作說明:

  • Claude Desktop:開啟 Claude >「設定」>「開發人員」>「編輯設定」,然後編輯 claude_desktop_config.json。
  • Cline:按一下「MCP 伺服器」圖示,然後按一下「設定 MCP 伺服器」進行編輯。cline_mcp_settings.json
  • 游標:編輯單一專案的 .cursor/mcp.json 或所有專案的 ~/.cursor/mcp.json。
  • Gemini CLI (手動設定):如未使用擴充功能,請編輯單一專案的 .gemini/settings.json 或所有專案的 ~/.gemini/settings.json。

  • 如果是 Visual Studio Code,請編輯工作區中的 .vscode/mcp.json 檔案 (適用於單一專案),或是編輯全域使用者設定檔 (適用於所有專案):

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

免責事項

AI 輔助作業仍在發展中;雖然我們以準確度為優先考量,但請注意,模型驅動的輸出內容可能包含不準確之處,因此請務必檢查內容是否正確。

後續步驟