Backup and DR ローカル Model Context Protocol(MCP)サーバーを使用すると、AI アシスタントと LLM 搭載アプリケーションがバックアップ環境と安全にやり取りできます。サーバーをローカルで実行すると、生成 AI を使用して、ローカル環境を制御しながら、自然言語プロンプトを使用して Backup and DR タスク(Backup Vault やバックアップ プランの作成、アラート通知の有効化など)を管理できます。 MCP サーバーを使用してサービス間でやり取りする方法の詳細をご確認ください Google Cloud サービス。
Backup and DR ローカル MCP サーバーは、 MCP 互換ホスト(Gemini CLI、ChatGPT、Claude Code など)と Backup and DR API の橋渡し役として機能します。 Google Cloud
サーバーはワークステーションで実行されるため、AI はローカル 認証情報とネットワーク パスを使用して と直接通信できます Google Cloud。
Backup and DR ローカル MCP サーバーには、次の利点があります。
- AI による管理: 自然言語プロンプトを使用して、複雑な Backup and DR タスクを自動化して 簡素化します。
- セキュリティ: データは定義された境界内に留まります。ローカル サーバーは、既存の Google Cloud CLI 認証を使用します。
- トラブルシューティングの簡素化: バックアップと 復元のジョブの失敗を特定してユーザーに通知し、エラーを修正するための修復手順を取得します。
- 一元的な検出: 同じ MCP 環境を使用して、Cloud Monitoring、Cloud Storage、BigQuery などの複数のサービス間でやり取りします。 Google Cloud
始める前に
Backup and DR のローカル MCP サーバーを設定する前に、次のものがあることを確認してください。
- Backup and DR、Compute Engine、Cloud SQL API が有効になっている Google Cloud プロジェクト 。
- Gemini CLI などの MCP ホスト。
- 次のものがある ローカル環境 。
- Node.js(v20 以降)
- Google Cloud SDK(Google Cloud CLI)が初期化され、認証されている。
必要な権限
ユーザーがローカル MCP サーバーを使用して対応するタスクを実行するには、関連する Identity and Access Management(IAM)のロールと権限が必要です。次に例を示します。
roles/backupdr.viewer(メタデータ情報とステータスをクエリする)roles/backupdr.restoreUser(復元をトリガーする)
ローカル MCP サーバーを設定する
Gemini CLI をインストールして Backup and DR ローカル MCP サーバーを設定する手順は次のとおりです。
Gemini CLI をインストールする
Backup and DR ローカル MCP サーバーを Gemini CLI または Gemini Code Assist と統合するには、次の設定コマンドを実行します。これにより、MCP サーバーが現在のユーザーの Gemini CLI 拡張機能としてインストールされ、すべてのプロジェクトで使用できるようになります。
npm install -g @google/gemini-cli詳細については、 https://geminicli.com/docs/get-started/installationをご覧ください。
Backup and DR ローカル MCP サーバーを設定する
Backup and DR 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=UPSERTすべて: 削除などの破壊的なオペレーションを含むすべてのツールを提供します。
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
- フラグ:
コンテキスト ファイルを構成する
コンテキスト ファイルは、Gemini モデルに指示コンテキストを提供する強力な機能です。Backup and DR 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)を使用してオペレーションを実行します。 Backup and DR サービスに適用される IAM チェックは、ADC で実行されます。アプリケーションのデフォルト認証情報の詳細については、 アプリケーションのデフォルト認証情報を設定するをご覧ください。
認証情報を構成するには、次のコマンドを実行します。
gcloud auth application-default login独自の認証情報の代わりにサービス アカウントの認証情報を使用するには、アプリケーションのデフォルト認証情報(ADC)を使用してサービス アカウントの権限を借用します。サービス アカウントの権限を借用するには、次のコマンドを実行します。
gcloud auth application-default login --impersonate-service-account [SERVICE_ACCOUNT_EMAIL]
使用可能なツール
Backup and DR ローカル MCP サーバーには、次のツールが含まれています。
読み取り専用ツール
これらのツールを使用すると、編集を許可せずに Backup and DR リソースを検出して検査できます。
| ツール | 説明 |
|---|---|
list_backup_vaults |
プロジェクトとロケーション内のすべての Backup Vault を一覧表示します。 |
get_backup_vault |
特定の Backup Vault の詳細を取得します。 |
list_backup_plans |
プロジェクトとロケーション内のすべてのバックアップ プランを一覧表示します。 |
get_backup_plan |
特定のバックアップ プランの詳細を取得します。 |
list_backup_plan_associations |
バックアップ プランとリソース間のすべての関連付けを一覧表示します。 |
get_backup_plan_association |
特定のバックアップ プランの関連付けの詳細を取得します。 |
list_datasources |
Backup Vault 内のすべてのデータソースを一覧表示します。 |
get_datasource |
特定のデータソースの詳細を取得します。 |
list_backups |
特定のデータソースのすべてのバックアップを一覧表示します。 |
get_backup |
特定のバックアップの詳細を取得します。 |
find_protectable_resources |
保護可能なリソース(VM、ディスク、SQL)を検出します。 |
get_backupdr_operation |
長時間実行されている Backup and DR オペレーションのステータスを取得します。 |
get_csql_operation |
長時間実行されている Cloud SQL オペレーションのステータスを取得します。 |
Upsert ツール
これらのツールを使用すると、復元オペレーションを含むリソースの作成と更新を行うことができます。
| ツール | 説明 |
|---|---|
create_backup_vault |
指定されたロケーションに新しい Backup Vault を作成します。 |
create_backup_plan |
ルールと保持期間を使用して新しいバックアップ プランを作成します。 |
update_backup_plan |
既存のバックアップ プランを変更します。 |
create_backup_plan_association |
リソースをバックアップ プランに関連付けます。 |
restore_backup |
バックアップをターゲットの Compute Engine インスタンスまたはディスクに復元します。 |
csql_restore |
Cloud SQL バックアップをターゲット インスタンスに復元します。 |
削除ツール
これらのツールには、リソースを削除する機能が含まれています。アクセスレベルを ALL に設定して、必要な場合にのみ有効にします。
| ツール | 説明 |
|---|---|
delete_backup_vault |
Backup Vault を削除します。 |
delete_backup_plan |
バックアップ プランを削除します。 |
delete_backup_plan_association |
リソースから保護を削除します。 |
delete_backup |
Vault から特定のバックアップを削除します。 |
プロンプトの例
サーバーが接続されると、AI クライアントで自然言語プロンプトを使用してバックアップ環境を管理できます。
プロジェクト全体のバックアップの健全性を評価する
Show the list of unprotected resources in project PROJECT_ID for region LOCATION.次のように置き換えます。
PROJECT_ID: バックアップの健全性を確認するプロジェクト ID。LOCATION: リソースが配置されているリージョン。
Backup Vault とバックアップ プランを作成する
Create a backup vault named VAULT_NAME in LOCATION to protect resource RESOURCE_NAME using backup plan PLAN_NAME.次のように置き換えます。
VAULT_NAME: 新しい Backup Vault の名前。LOCATION: Vault を作成するリージョン。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 クライアントを使用してサーバーにアクセスする
Backup and DR 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 のドキュメントを参照する。
- アプリケーションのデフォルト認証情報について学習する。