Gemini Cloud Assist

Servidor MCP de Gemini Cloud Assist

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

[!WARNING] Aviso de Desaprobación 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 servidor local anterior 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) con las APIs de Gemini Cloud Assist. Te permite usar lenguaje natural para comprender, gestionar y solucionar problemas de tu entorno de Google Cloud directamente desde la línea de comandos local.

[!NOTE] Los Términos del Servicio de la Plataforma Google Cloud (disponibles en https://cloud.google.com/terms/) y los Términos de Procesamiento de Datos y Seguridad (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.

✨ Características clave

• Diseñar infraestructura: Crea y arquitectura configuraciones de infraestructura para Google Cloud.
• Solucionar problemas: Realiza investigaciones profundas para encontrar la causa raíz de problemas complejos en tu entorno de Google Cloud.
• Gestionar recursos: Crea, actualiza y elimina recursos de Google Cloud directamente desde tu flujo de trabajo de chat (requiere Acciones de Agente).
• Optimizar costos: Analiza tu gasto, 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: Requerido para habilitar las APIs de Cloud Assist.
  • roles/geminicloudassist.user: Requerido para realizar solicitudes a las APIs de Cloud Assist.

Paso 1: Autentícate en Google Cloud

El servidor MCP de Gemini Cloud Assist utiliza Credenciales Predeterminadas de Aplicación (ADC) locales para autenticarse de forma segura en Google Cloud. Para configurar ADC, ejecuta los siguientes comandos 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

Configura tu cliente MCP

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

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 redirección.
3. Agrega o combina 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 llamadas a herramientas MCP realiza sus propias llamadas internas 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 arquitecturar infraestructura en Google Cloud.
investigate_issue	Admite flujos de trabajo para la resolución de problemas en Google Cloud. Puede realizar una resolución rápida o una resolución 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 es funcional cuando las Acciones de Agente están habilitadas.
optimize_costs	Admite flujos de trabajo para analizar, rastrear y optimizar los costos de Google Cloud. Proporciona desgloses del gasto e identifica oportunidades de eficiencia de costos.

Herramientas MCP del Centro de Diseño de Aplicaciones

Las herramientas del 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, incluida la gestión de plantillas, el cumplimiento y la corrección de seguridad, y la implementación.

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 otras herramientas ADC puedan usarse.
manage_application	Gestiona el ciclo de vida de implementación de una aplicación. Usa esta herramienta para implementar un diseño verificado usando el Centro de Diseño de Aplicaciones u obtener el estado y los detalles de una implementación existente. Este es el paso final que convierte tu diseño en una infraestructura implementada en Google Cloud.
manage_application_template	Gestiona el contenido de Infraestructura como Código (IaC) de tu diseño de infraestructura. Úsalo 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, componentes, configuraciones de parámetros, etc.).
assess_best_practices	Realiza una auditoría integral de seguridad y configuración en tu diseño de aplicación antes de la implementación. Valida el diseño contra los marcos de trabajo del Centro de Comando de Seguridad y los controles relevantes, devolviendo un informe con hallazgos procesables para la 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 los archivos SKILL.md para instruir a tu agente sobre cómo usar las herramientas correctamente. Las habilidades ayudan a guiar a tu agente para 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, implementar y solucionar problemas de infraestructura en la nube usando el Centro de Diseño de Aplicaciones (ADC) y las herramientas de Gemini Cloud Assist.
operating-google-cloud	Proporciona instrucciones para gestionar recursos de la Plataforma Google Cloud (GCP) y Kubernetes usando herramientas MCP especializadas.

Contribuciones

• Si encuentras un error, por favor reporta un problema en nuestra página de Problemas de GitHub.
• Antes de enviar una solicitud de extracción, revisa nuestra Guía de Contribuciones.

Licencia

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