透過 Backup and DR Local Model Context Protocol (MCP) 伺服器,AI 助理和以大型語言模型為基礎的應用程式就能安全地與備份和災難復原環境互動。在本機執行伺服器時,您可以使用生成式 AI,透過自然語言提示管理備份和災難復原工作,例如建立備份儲存空間和備份方案,或啟用快訊通知,同時維持對本機環境的控制權。進一步瞭解如何使用 MCP 伺服器跨服務互動 Google Cloud 。
備份和災難復原 本機 MCP 伺服器可做為 MCP 相容主機 (例如 Gemini CLI、ChatGPT 或 Claude Code) 與 Google Cloud 備份和災難復原 API 之間的橋梁。
由於伺服器是在工作站上執行,AI 可以使用本機憑證和網路路徑,直接與 Google Cloud通訊。
備份和災難復原本機 MCP 伺服器具有下列優點:
- AI 輔助管理:使用自然語言提示自動執行及簡化複雜的備份和災難復原工作。
- 安全性:您的資料會留在您定義的範圍內。本機伺服器會使用現有的 gcloud CLI 驗證。
- 簡化疑難排解程序:找出備份和還原工作失敗的原因,並向使用者發出快訊,同時提供修正錯誤的補救步驟。
- 集中式探索:使用相同的 MCP 環境,與多項 Google Cloud 服務互動,例如 Cloud Monitoring、Cloud Storage 和 BigQuery。
事前準備
為備份和災難復原設定本機 MCP 伺服器前,請確認您具備下列項目:
- 已啟用備份和災難復原、Compute Engine 和 Cloud SQL API 的 Google Cloud 雲端專案。
- MCP 主機,例如 Gemini CLI。
- 具備下列項目的本機環境:
- Node.js (v20 以上版本)
- 已初始化並驗證 Google Cloud SDK (gcloud CLI)。
所需權限
使用者必須具備相關的 Identity and Access Management (IAM) 角色和權限,才能使用本機 MCP 伺服器執行對應工作。例如:
roles/backupdr.viewer(查詢中繼資料資訊和狀態)roles/backupdr.restoreUser(觸發還原作業)
設定本機 MCP 伺服器
如要安裝 Gemini CLI 並設定備份和災難復原本機 MCP 伺服器,請按照下列步驟操作:
安裝 Gemini CLI
如要將備份和災難復原本機 MCP 伺服器與 Gemini CLI 或 Gemini Code Assist 整合,請執行這項設定指令。這會將 MCP 伺服器安裝為目前使用者的 Gemini CLI 擴充功能,讓所有專案都能使用。
npm install -g @google/gemini-cli設定備份和災難復原本機 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設定本機 MCP 伺服器
您可以使用下列標記自訂 MCP 伺服器行為。
設定存取層級。
存取層級會控管 AI 代理可使用的工具。
- 旗標:
--access-level 值:
READ_ONLY(預設)、UPSERT、ALLREAD_ONLY:提供唯讀工具,用於探索和檢查。
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLYUPSERT:提供探索、檢查、建立和更新工具 (包括還原)。
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERTALL:提供所有工具,包括刪除等破壞性作業。
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
- 旗標:
設定結構定義檔案
脈絡檔案是一項強大功能,可為 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 檔案提供脈絡」。
設定使用者驗證和授權
MCP 伺服器會使用應用程式預設憑證 (ADC) 執行作業。 系統會在 ADC 上執行適用於備份和災難復原服務的 IAM 檢查。如要進一步瞭解應用程式預設憑證,請參閱「設定應用程式預設憑證」。
如要設定憑證,請執行下列指令:
gcloud auth application-default login如要使用服務帳戶憑證而非自己的憑證,請使用應用程式預設憑證 (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 中區域 LOCATION 的未受保護資源清單)。
更改下列內容:
PROJECT_ID:要檢查備份健康狀態的專案 ID。LOCATION:資源所在的區域。
建立備份保存庫和備份方案
「在 LOCATION 中建立名為 VAULT_NAME 的備份儲存空間,使用備份方案 PLAN_NAME 保護資源 RESOURCE_NAME。」
更改下列內容:
VAULT_NAME:新備份保存庫的名稱。LOCATION:要建立保存庫的區域。RESOURCE_NAME:要保護的資源名稱。PLAN_NAME:要套用的備份方案名稱。
稽核備份內容是否符合法規
「Audit all backups in the project PROJECT_ID in the region LOCATION. 稽核完成後,請根據稽核結果與我的公司備份政策進行比較,找出任何不符規定的地方。」
更改下列內容:
PROJECT_ID:要稽核的專案 ID。LOCATION:要稽核的區域。
失敗的根本原因分析
這則提示需要使用
observability工具。如要安裝這項 MCP 工具,請參閱 GitHub 上的「Available MCP Tools」(可用的 MCP 工具)。「Identify and investigate the root cause of the resource backup failure in the last days in project.」(找出並調查專案 PROJECT_ID 中,資源 RESOURCE_NAME 在過去 DURATION 天備份失敗的根本原因)。
更改下列內容:
RESOURCE_NAME:備份失敗的資源名稱。DURATION:調查的時間範圍 (例如7)。PROJECT_ID:發生失敗的專案 ID。
還原備份
「從專案 PROJECT_ID 還原資源 RESOURCE_NAME 的最新備份。將還原的執行個體命名為 NEW_INSTANCE_NAME。
更改下列內容:
RESOURCE_NAME:要還原的資源名稱。PROJECT_ID:包含備份的專案 ID。NEW_INSTANCE_NAME:還原的執行個體名稱。
建立警告政策
您可以針對任意組合的記錄和新增篩選器啟用快訊。
這則提示需要使用
gcloud工具。如要安裝這項 MCP 工具,請參閱 GitHub 上的「Available MCP Tools」(可用的 MCP 工具)。「建立名為『ALERT_NAME』的記錄型快訊政策,在
backupdr.googleapis.com中有任何嚴重程度為ERROR的記錄項目時觸發。立即傳送快訊通知到「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 輔助作業仍在發展中;雖然我們以準確度為優先考量,但請注意,模型驅動的輸出內容可能包含不準確之處,因此請務必檢查是否正確。
後續步驟
- 進一步瞭解 Google Cloud MCP 伺服器。
- 請參閱 Gemini CLI 說明文件。
- 進一步瞭解應用程式預設憑證。