Usa el servidor MCP local de Backup and DR para habilitar las operaciones de copia de seguridad con instrucciones en lenguaje natural

El servidor del Protocolo de contexto del modelo (MCP) local de Backup and DR permite que los asistentes de IA y las aplicaciones potenciadas por LLM interactúen de forma segura con tu entorno de copias de seguridad. Si ejecutas el servidor de forma local, puedes usar la IA generativa para administrar tareas de Backup and DR, como crear backup vaults y planes de copias de seguridad, o habilitar notificaciones de alertas, con instrucciones en lenguaje natural y, al mismo tiempo, mantener el control sobre tu entorno local. Obtén más información sobre cómo puedes usar los servidores de MCP para interactuar en los Google Cloud servicios.

El servidor de MCP local de Backup and DR actúa como un puente entre un host compatible con MCP (como Gemini CLI, ChatGPT o Claude Code) y la API de Google Cloud Backup and DR.

Como el servidor se ejecuta en tu estación de trabajo, la IA puede usar tus credenciales locales y la ruta de red para comunicarse directamente con Google Cloud.

El servidor de MCP local de Backup and DR proporciona los siguientes beneficios:

  • Administración basada en IA: Usa instrucciones en lenguaje natural para automatizar y simplificar tareas complejas de Backup and DR.
  • Seguridad: Tus datos permanecen dentro de los perímetros definidos. El servidor local usa tu autenticación existente de Google Cloud CLI.
  • Solución de problemas simplificada: Identifica las fallas en los trabajos de copia de seguridad y restablecimiento, y alerta a los usuarios al respecto. Además, obtén los pasos de corrección para solucionar los errores.
  • Detección centralizada: Interactúa en varios servicios de Google Cloud , como Cloud Monitoring, Cloud Storage y BigQuery, con el mismo entorno de MCP.

Antes de comenzar

Antes de configurar el servidor de MCP local para Backup and DR, asegúrate de tener lo siguiente:

  • Un proyecto de Google Cloud con las APIs de Backup and DR, Compute Engine y Cloud SQL habilitadas.
  • Un host de MCP, como Gemini CLI
  • Un entorno local con lo siguiente:
    • Node.js (v20 o versiones posteriores)
    • Google Cloud CLI (SDK de Google Cloud) inicializada y autenticada.

Permisos necesarios

Los usuarios necesitan los roles y permisos pertinentes de Identity and Access Management (IAM) para realizar las tareas correspondientes con el servidor MCP local. Por ejemplo:

  • roles/backupdr.viewer (para consultar información y el estado de los metadatos)
  • roles/backupdr.restoreUser (para activar la restauración)

Configura el servidor local de MCP

Para instalar Gemini CLI y configurar el servidor de MCP local de Backup and DR, sigue estos pasos:

  1. Instala Gemini CLI

    Para integrar el servidor de MCP local de Backup and DR con Gemini CLI o Gemini Code Assist, ejecuta este comando de configuración. Esto instalará el servidor de MCP como una extensión de Gemini CLI para el usuario actual, lo que lo hará disponible para todos tus proyectos.

    npm install -g @google/gemini-cli
    

    Para obtener más información, consulta https://geminicli.com/docs/get-started/installation.

  2. Configura el servidor de MCP local de Backup and DR

    Para instalar el servidor de MCP de Backup and DR, ejecuta este comando. De forma predeterminada, instala el servidor con el nivel de acceso READ_ONLY.

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

    Después del proceso de instalación, puedes verificar que el servidor de MCP de Backup and DR esté configurado correctamente ejecutando el siguiente comando:

    gemini mcp list
    

    El resultado debería mostrar un estado similar al siguiente:

    > ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - Connected
    
  3. Configura el servidor de MCP local

    Puedes personalizar el comportamiento del servidor de MCP con los siguientes parámetros.

    1. Configura el nivel de acceso.

      El nivel de acceso controla qué herramientas están disponibles para el agente de IA.

      • Bandera: --access-level
      • Valores: READ_ONLY (predeterminado), UPSERT, ALL

      • READ_ONLY: Proporciona herramientas de solo lectura para el descubrimiento y la inspección.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLY
        
      • UPSERT: Proporciona herramientas de descubrimiento, inspección, creación y actualización (incluidas las de restablecimiento).

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERT
        
      • ALL: Proporciona todas las herramientas, incluidas las operaciones destructivas, como la eliminación.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
        
    2. Configura el archivo de contexto

    Los archivos de contexto son una función potente para proporcionar contexto instructivo al modelo de Gemini. El servidor de MCP de Backup and DR incluye información de contexto sobre cómo usar herramientas y flujos de trabajo comunes.

    • Bandera: --overwrite-context-file
    • Valores: true, false (predeterminado)
    • Ubicación: ~/.gemini/backupdr-mcp/GEMINI.md

    De forma predeterminada, el archivo de contexto solo se crea si aún no existe. Para instalar el servidor de MCP y sobrescribir el archivo de contexto, ejecuta el siguiente comando:

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

    Cuando --overwrite-context-file se establece en falso, en la instalación de la extensión, el contexto se creará solo si aún no existe en el directorio.

    Para instalar el servidor MCP local sin anular el archivo de contexto, ejecuta el siguiente comando:

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

    Para obtener más detalles, consulta Cómo proporcionar contexto con archivos GEMINI.md.

  4. Configura la autenticación y la autorización de los usuarios

    El servidor de MCP usa credenciales predeterminadas de la aplicación (ADC) para realizar operaciones. Las verificaciones de IAM aplicables al servicio Backup and DR se realizan en el ADC. Para obtener más información sobre las credenciales predeterminadas de la aplicación, consulta Configura credenciales predeterminadas de la aplicación.

    1. Para configurar tus credenciales, ejecuta el siguiente comando:

      gcloud auth application-default login
      
    2. Para usar credenciales de cuenta de servicio en lugar de las tuyas, suplanta la identidad de una cuenta de servicio con las credenciales predeterminadas de la aplicación (ADC). Ejecuta el siguiente comando para suplantar una cuenta de servicio:

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

Herramientas disponibles

El servidor local de MCP de Backup and DR incluye las siguientes herramientas.

Herramientas de solo lectura

Estas herramientas permiten descubrir e inspeccionar los recursos de Backup and DR sin permitir ninguna edición.

Herramienta Descripción
list_backup_vaults Enumera todos los almacenes de copias de seguridad en un proyecto y una ubicación.
get_backup_vault Obtiene detalles de una bóveda de copias de seguridad específica.
list_backup_plans Enumera todos los planes de copia de seguridad en un proyecto y una ubicación.
get_backup_plan Obtiene detalles de un plan de copias de seguridad específico.
list_backup_plan_associations Enumera todas las asociaciones entre los planes de copias de seguridad y los recursos.
get_backup_plan_association Obtiene detalles de una asociación específica del plan de copias de seguridad.
list_datasources Enumera todas las fuentes de datos dentro de una backup vault.
get_datasource Obtiene detalles de una fuente de datos específica.
list_backups Enumera todas las copias de seguridad de una fuente de datos determinada.
get_backup Obtiene detalles de una copia de seguridad específica.
find_protectable_resources Descubre los recursos (VMs, discos, SQL) que se pueden proteger.
get_backupdr_operation Recupera el estado de una operación de larga duración de Backup and DR.
get_csql_operation Recupera el estado de una operación de Cloud SQL de larga duración.

Herramientas de upsert

Estas herramientas permiten crear y actualizar recursos, incluidas las operaciones de restablecimiento.

Herramienta Descripción
create_backup_vault Crea una nueva bóveda de copias de seguridad en una ubicación especificada.
create_backup_plan Crea un plan de copias de seguridad nuevo con reglas y retención.
update_backup_plan Modifica un plan de copias de seguridad existente.
create_backup_plan_association Asocia un recurso con un plan de copia de seguridad.
restore_backup Restablece una copia de seguridad en un disco o instancia de destino de Compute Engine.
csql_restore Restablece una copia de seguridad de Cloud SQL en una instancia de destino.

Herramientas de borrado

Estas herramientas incluyen la capacidad de borrar recursos. Habilítalos solo cuando sea necesario configurando el nivel de acceso en ALL.

Herramienta Descripción
delete_backup_vault Borra una bóveda de copias de seguridad.
delete_backup_plan Borra un plan de copias de seguridad.
delete_backup_plan_association Quita la protección de un recurso.
delete_backup Borra una copia de seguridad específica de una bóveda.

Ejemplos de instrucciones

Una vez que el servidor esté conectado, podrás usar instrucciones en lenguaje natural en tu cliente de IA para administrar tu entorno de copia de seguridad.

  • Evalúa el estado de las copias de seguridad en un proyecto

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

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que deseas verificar el estado de la copia de seguridad.
    • LOCATION: Es la región en la que se encuentran tus recursos.
  • Crea una bóveda de copias de seguridad y un plan de copias de seguridad

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

    Reemplaza lo siguiente:

    • VAULT_NAME: Es el nombre de la nueva backup vault.
    • LOCATION: Es la región en la que deseas crear la bóveda.
    • RESOURCE_NAME: Es el nombre del recurso que se protegerá.
    • PLAN_NAME: Es el nombre del plan de copia de seguridad que se aplicará.
  • Audita las copias de seguridad para garantizar el cumplimiento

    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.
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto que se auditará.
    • LOCATION: Es la región que se auditará.
  • Análisis de la causa raíz de las fallas

    Esta instrucción requiere la herramienta observability. Para instalar esta herramienta de MCP, consulta Available MCP Tools en GitHub.

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

    Reemplaza lo siguiente:

    • RESOURCE_NAME: Es el nombre del recurso con errores de copia de seguridad.
    • DURATION: Es el período para la investigación (por ejemplo, 7).
    • PROJECT_ID: Es el ID del proyecto en el que se produjo la falla.
  • Restablecer una copia de seguridad

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

    Reemplaza lo siguiente:

    • RESOURCE_NAME: Es el nombre del recurso que se restablecerá.
    • PROJECT_ID: ID del proyecto que contiene la copia de seguridad.
    • NEW_INSTANCE_NAME: Es el nombre de la instancia restaurada.
  • Crea una política de alertas

    Puedes habilitar alertas para cualquier combinación de registros y filtros agregados.

    Esta instrucción requiere la herramienta gcloud. Para instalar esta herramienta de MCP, consulta Available MCP Tools en GitHub.

    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.
    

    Reemplaza lo siguiente:

    • ALERT_NAME: Es un nombre para la nueva política de alertas.
    • EMAIL_ADDRESS: Es el correo electrónico para recibir notificaciones.

Accede al servidor con otros clientes de IA

Puedes usar el servidor MCP de Backup and DR con otros clientes.

  • Para ello, agrega el siguiente fragmento a sus respectivos archivos de configuración JSON:

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

Instrucciones para herramientas populares:

  • Claude Desktop: Abre Claude > Configuración > Desarrollador > Editar configuración y edita claude_desktop_config.json.
  • Cline: Haz clic en el ícono de los servidores de MCP y, luego, en Configure MCP Servers para editar cline_mcp_settings.json.
  • Cursor: Edita .cursor/mcp.json para un solo proyecto o ~/.cursor/mcp.json para todos los proyectos.
  • Gemini CLI (configuración manual): Si no usas extensiones, edita .gemini/settings.json para un solo proyecto o ~/.gemini/settings.json para todos los proyectos.

  • En Visual Studio Code, edita el archivo .vscode/mcp.json en tu espacio de trabajo para un solo proyecto o tu archivo de configuración global del usuario para todos los proyectos:

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

Aviso importante

Las operaciones asistidas por IA aún están en evolución. Si bien priorizamos la precisión, ten en cuenta que los resultados basados en modelos pueden incluir imprecisiones y siempre deben revisarse para garantizar su exactitud.

¿Qué sigue?