Gemini Cloud Assist

Servidor MCP de Gemini Cloud Assist

[!IMPORTANT] Aviso de Vista Previa Privada Las APIs del servidor MCP de Gemini Cloud Assist están actualmente en Vista Previa Privada y detrás de una lista de permitidos. Comunícate con tu equipo de cuentas de Google Cloud para solicitar acceso.

[!WARNING] Aviso de Desuso y Migración al Servidor MCP Remoto

El servidor MCP de Gemini Cloud Assist ha migrado de una arquitectura local de Node.js a una arquitectura de Servidor MCP Remoto. El antiguo servidor local de Node.js perderá soporte en los próximos meses.

Para usar los nuevos Servidores MCP Remotos, utiliza la versión v0.8.0 o posterior. Si deseas continuar usando el servidor local heredado durante la transición, fija tu configuración a versiones anteriores.

Este servidor conecta clientes del Protocolo de Contexto de Modelo (MCP) como Gemini CLI a las APIs de Gemini Cloud Assist. Te permite usar lenguaje natural para comprender, administrar y solucionar problemas de tu entorno de Google Cloud directamente desde la línea de comandos local.

[!NOTE] Los Términos del Servicio de Google Cloud Platform (disponibles en https://cloud.google.com/terms/) y los Términos de Procesamiento y Seguridad de Datos (disponibles en https://cloud.google.com/terms/data-processing-terms) no se aplican a ningún componente del software del Servidor MCP de Gemini Cloud Assist.

Para obtener más información sobre Gemini Cloud Assist, consulta la descripción general de Gemini Cloud Assist en la documentación de Google Cloud.

✨ Funciones clave

• Diseñar infraestructura: Crea y diseña configuraciones de infraestructura para Google Cloud.
• Solucionar problemas: Ejecuta investigaciones profundas para encontrar la causa raíz de problemas complejos en tu entorno de Google Cloud.
• Administrar recursos: Crea, actualiza y elimina recursos de Google Cloud directamente desde tu flujo de trabajo de chat (requiere Acciones del Agente).
• Optimizar costos: Analiza tus gastos, realiza un seguimiento de los costos e identifica oportunidades de eficiencia, como recursos inactivos.
• Obtener asistencia general: Haz preguntas y recibe orientación sobre las mejores prácticas, arquitecturas y operaciones de Google Cloud.

Inicio rápido

Antes de comenzar, asegúrate de tener lo siguiente configurado:

• SDK de Google Cloud instalado y configurado.
• Un proyecto de Google Cloud.
• Los siguientes roles de IAM en tu cuenta de usuario:
  • roles/serviceusage.serviceUsageAdmin: Necesario para habilitar las APIs de Cloud Assist.
  • roles/geminicloudassist.user: Necesario para realizar solicitudes a las APIs de Cloud Assist.

Paso 1: Autenticarse en Google Cloud

El servidor MCP de Gemini Cloud Assist utiliza las Credenciales Predeterminadas de la Aplicación (ADC) locales para autenticarse de forma segura en Google Cloud. Para configurar ADC, ejecuta los siguientes comandos de gcloud:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

Configurar tu cliente MCP

La configuración del agente cliente depende del agente que estés utilizando.

Gemini CLI

Instala el servidor MCP como una extensión de Gemini CLI:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Alternativamente, puedes agregar manualmente la configuración a tu ~/.gemini/settings.json:

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

Antigravity

Agrega lo siguiente a tu mcp_config.json:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. En tu proyecto de Google Cloud, crea un ID de cliente OAuth 2.0 para una aplicación de escritorio.
2. Configura URI://anysphere.cursor-mcp/oauth/callback como la URL de redireccionamiento.
3. Agrega o fusiona el siguiente bloque de configuración:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

Sigue las instrucciones de configuración para tu aplicación específica:

• Claude.ai

Herramientas MCP

Herramientas MCP de Gemini Cloud Assist

Gemini Cloud Assist es un agente accesible a través de un conjunto de herramientas MCP. El agente invocado por las llamadas a las herramientas MCP realiza sus propias llamadas a herramientas internamente a Google Cloud. Las siguientes herramientas MCP se publican para que los agentes las consuman:

Herramienta	Descripción
ask_cloud_assist	La interfaz principal para la asistencia de Google Cloud y para el agente de Gemini Cloud Assist. Toda la funcionalidad es accesible a través de esta herramienta.
design_infra	Admite flujos de trabajo para diseñar y crear arquitecturas de infraestructura en Google Cloud.
investigate_issue	Admite flujos de trabajo para la solución de problemas en Google Cloud. Puede realizar solución de problemas rápida o más profunda a través de un recurso de Investigación.
invoke_operation	Admite flujos de trabajo para crear, actualizar y eliminar recursos en Google Cloud. Solo funciona cuando las Acciones del Agente están habilitadas.
optimize_costs	Admite flujos de trabajo para analizar, rastrear y optimizar los costos de Google Cloud. Proporciona desgloses de gastos e identifica oportunidades para la eficiencia de costos.

Herramientas MCP del Centro de Diseño de Aplicaciones

Las herramientas MCP del Centro de Diseño de Aplicaciones, a menudo orquestadas por la herramienta design_infra de GCA, gestionan el ciclo de vida de la aplicación de infraestructura utilizando el Centro de Diseño de Aplicaciones, incluyendo la gestión de plantillas, el cumplimiento de seguridad, la corrección y el despliegue.

Herramienta	Descripción
setup_adc	Inicializa el entorno del Centro de Diseño de Aplicaciones. Este es un paso de configuración único que debe realizarse antes de que se puedan usar otras herramientas de ADC.
manage_application	Gestiona el ciclo de vida de despliegue de una aplicación. Usa esta herramienta para desplegar un diseño verificado usando el Centro de Diseño de Aplicaciones o para recuperar el estado y los detalles de un despliegue existente. Este es el paso final que convierte tu diseño en una infraestructura desplegada en Google Cloud.
manage_application_template	Gestiona el contenido de Infraestructura como Código (IaC) de tu diseño de infraestructura. Úsala para guardar el diseño como una plantilla del Centro de Diseño de Aplicaciones, exportar el diseño como archivos de Terraform o actualizar el diseño (por ejemplo, configuraciones de componentes, parámetros, etc.).
assess_best_practices	Realiza una auditoría integral de seguridad y configuración en el diseño de tu aplicación antes del despliegue. Valida el diseño contra los marcos del Centro de Comando de Seguridad y los controles relevantes, devolviendo un informe con hallazgos accionables para su corrección.
list_application_templates	Enumera todos los diseños de aplicaciones disponibles.

Nota: Estas herramientas no deben tratarse como APIs estables. Los parámetros pueden renombrarse o modificarse para tener en cuenta las capacidades en evolución de Gemini Cloud Assist.

Habilidades del Agente

Las herramientas MCP de Gemini Cloud Assist aprovechan archivos SKILL.md para instruir a tu agente sobre cómo usar las herramientas correctamente. Las habilidades ayudan a guiar a tu agente sobre cómo encadenar múltiples herramientas en un flujo de trabajo, pasar información local relevante a Gemini Cloud Assist y habilitar la invocación explícita.

Habilidad	Descripción
designing-and-deploying-infrastructure	Guía al agente sobre cómo diseñar, evaluar, desplegar y solucionar problemas de infraestructura en la nube utilizando las herramientas del Centro de Diseño de Aplicaciones (ADC) y Gemini Cloud Assist.
operating-google-cloud	Proporciona instrucciones para administrar recursos de Google Cloud Platform (GCP) y Kubernetes utilizando herramientas MCP especializadas.

Contribuciones

• Si encuentras un error, presenta un problema en nuestra página de GitHub Issues.
• Antes de enviar una solicitud de extracción, revisa nuestra Guía de Contribución.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0 y se proporciona tal cual, sin garantía ni representación para ningún uso o propósito. Para más detalles, consulta el archivo LICENSE.