Usa el servidor MCP local de Backup and DR

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 copia 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 copia de seguridad, o habilitar notificaciones de alertas, con instrucciones de lenguaje natural mientras mantienes el control sobre tu entorno local. Obtén más información sobre cómo puedes usar los servidores de MCP para interactuar entre 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 Google Cloud API de 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 de 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 la CLI de gcloud.
  • Solución de problemas simplificada: Identifica y alerta a los usuarios sobre las fallas de los trabajos de copia de seguridad y restablecimiento, y obtén pasos de corrección para solucionar los errores.
  • Descubrimiento centralizado: Interactúa entre varios Google Cloud servicios, 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 la CLI de Gemini.
  • Un entorno local con lo siguiente:
    • Node.js (v20+)
    • El SDK de Google Cloud (CLI de gcloud) inicializado y autenticado.

Permisos necesarios

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

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

Configura el servidor de MCP local

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

  1. Instala la CLI de Gemini

    Para integrar el servidor de MCP local de Backup and DR con la CLI de Gemini o Gemini Code Assist, ejecuta este comando de configuración. Esto instalará el servidor de MCP como una extensión de la CLI de Gemini 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 en 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 las siguientes marcas.

    1. Configura el nivel de acceso.

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

      • Marca: --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 (incluidos los restablecimientos).

        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.

    • Marca: --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 reemplazar 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 de MCP local sin reemplazar 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 Proporciona 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 a Backup and DR se realizan en las ADC. Para obtener más información sobre las credenciales predeterminadas de la aplicación, consulta Configura las 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 una cuenta de servicio con 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 de MCP local de Backup and DR incluye las siguientes herramientas.

Herramientas de solo lectura

Estas herramientas permiten el descubrimiento y la inspección de los recursos de Backup and DR sin permitir ninguna edición.

Herramienta Descripción
list_backup_vaults Muestra una lista de todos los backup vaults de un proyecto y una ubicación.
get_backup_vault Obtiene detalles de un backup vault específico.
list_backup_plans Muestra una lista de todos los planes de copia de seguridad de un proyecto y una ubicación.
get_backup_plan Obtiene detalles de un plan de copia de seguridad específico.
list_backup_plan_associations Muestra una lista de todas las asociaciones entre los planes de copia de seguridad y los recursos.
get_backup_plan_association Obtiene detalles de una asociación de plan de copia de seguridad específica.
list_datasources Muestra una lista de todas las fuentes de datos dentro de un backup vault.
get_datasource Obtiene detalles de una fuente de datos específica.
list_backups Muestra una lista de 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 recursos (VMs, discos, SQL) que se pueden proteger.
get_backupdr_operation Recupera el estado de una operación de Backup and DR de larga duración.
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 un nuevo backup vault en una ubicación especificada.
create_backup_plan Crea un nuevo plan de copia de seguridad con reglas y retención.
update_backup_plan Modifica un plan de copia 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 una instancia o un disco de destino de Compute Engine.
csql_restore Restablece una copia de seguridad de Cloud SQL en una instancia de destino.

Borrar herramientas

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

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

Ejemplos de instrucciones

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

  • Evalúa el estado de la copia de seguridad en un proyecto

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

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto en el que deseas verificar el estado de la copia de seguridad.
    • LOCATION: La región en la que se encuentran tus recursos.

  • Crea un backup vault y un plan de copia 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: El nombre del nuevo backup vault.
    • LOCATION: La región en la que deseas crear el vault.
    • RESOURCE_NAME: El nombre del recurso que se protegerá.
    • PLAN_NAME: El nombre del plan de copia de seguridad que se aplicará.

  • Audita las copias de seguridad para 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: El ID del proyecto que se auditará.
    • LOCATION: 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 Herramientas de MCP disponibles 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: El nombre del recurso con fallas de copia de seguridad.
    • DURATION: El período de la investigación (por ejemplo, 7).
    • PROJECT_ID: El ID del proyecto en el que ocurrió 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: El nombre del recurso que se restablecerá.
    • PROJECT_ID: El ID del proyecto que contiene la copia de seguridad.
    • NEW_INSTANCE_NAME: Un nombre para la instancia restablecida.

  • 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 Herramientas de MCP disponibles en GitHub.

    "Create a log-based alert policy named ALERT_NAME to trigger on any entrada de registro from backupdr.googleapis.com with severity ERROR. Send notification of the alerts immediately to EMAIL_ADDRESS."

    Reemplaza lo siguiente:

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

Accede al servidor con otros clientes de IA

Puedes usar el servidor de 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 de usuario global 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 exactitud, ten en cuenta que los resultados basados en modelos pueden incluir imprecisiones y siempre deben revisarse para verificar su exactitud.

¿Qué sigue?