Backup and DR ローカル MCP サーバーを使用して、自然言語プロンプトでバックアップ オペレーションを有効にする

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 サーバーを設定する手順は次のとおりです。

  1. 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をご覧ください。

  2. 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
    
  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
        
      • すべて: 削除などの破壊的なオペレーションを含むすべてのツールを提供します。

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
        
    2. コンテキスト ファイルを構成する

    コンテキスト ファイルは、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 ファイルでコンテキストを提供するをご覧ください。

  4. ユーザーの認証と認可を構成する

    MCP サーバーは、アプリケーションのデフォルト認証情報(ADC)を使用してオペレーションを実行します。 Backup and DR サービスに適用される IAM チェックは、ADC で実行されます。アプリケーションのデフォルト認証情報の詳細については、 アプリケーションのデフォルト認証情報を設定するをご覧ください。

    1. 認証情報を構成するには、次のコマンドを実行します。

      gcloud auth application-default login
      
    2. 独自の認証情報の代わりにサービス アカウントの認証情報を使用するには、アプリケーションのデフォルト認証情報(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 による支援はまだ進化の途上にあります。正確性を優先していますが、モデル駆動型の出力には不正確な情報が含まれる可能性があるため、常に正確性を確認してください。

次のステップ