Gemini Cloud Assist

Serveur MCP Gemini Cloud Assist

[!IMPORTANT] Avis d'aperçu privé Les API du serveur MCP Gemini Cloud Assist sont actuellement en aperçu privé et sont soumises à une liste d'autorisation. Veuillez contacter votre équipe de compte Google Cloud pour demander l'accès.

[!WARNING] Avis d'abandon et migration vers le serveur MCP distant

Le serveur MCP Gemini Cloud Assist est passé d'une architecture Node.js locale à une architecture de serveur MCP distant. L'ancien serveur Node.js local ne sera plus pris en charge dans les mois à venir.

Pour utiliser les nouveaux serveurs MCP distants, veuillez utiliser la version v0.8.0 ou ultérieure. Si vous souhaitez continuer à utiliser l'ancien serveur local pendant la transition, veuillez épingler votre configuration aux versions antérieures.

Ce serveur connecte les clients Model Context Protocol (MCP) tels que Gemini CLI aux API Gemini Cloud Assist. Il vous permet d'utiliser le langage naturel pour comprendre, gérer et dépanner votre environnement Google Cloud directement depuis la ligne de commande locale.

[!NOTE] Les Conditions d'utilisation de Google Cloud Platform (disponibles sur https://cloud.google.com/terms/) et les Conditions de traitement et de sécurité des données (disponibles sur https://cloud.google.com/terms/data-processing-terms) ne s'appliquent à aucun composant du logiciel du serveur MCP Gemini Cloud Assist.

Pour en savoir plus sur Gemini Cloud Assist, consultez la présentation de Gemini Cloud Assist dans la documentation Google Cloud.

✨ Fonctionnalités clés

• Concevoir l'infrastructure : Créer et architecturer des configurations d'infrastructure pour Google Cloud.
• Résoudre les problèmes : Exécuter des investigations approfondies pour trouver la cause racine de problèmes complexes dans votre environnement Google Cloud.
• Gérer les ressources : Créer, mettre à jour et supprimer des ressources Google Cloud directement depuis votre flux de travail de chat (nécessite des actions d'agent).
• Optimiser les coûts : Analyser vos dépenses, suivre les coûts et identifier les opportunités d'efficacité telles que les ressources inactives.
• Obtenir une assistance générale : Poser des questions et obtenir des conseils sur les meilleures pratiques, les architectures et les opérations de Google Cloud.

Démarrage rapide

Avant de commencer, assurez-vous d'avoir configuré les éléments suivants :

• Google Cloud SDK installé et configuré.
• Un projet Google Cloud.
• Les rôles IAM suivants sur votre compte utilisateur :
  • roles/serviceusage.serviceUsageAdmin : Requis pour activer les API Cloud Assist.
  • roles/geminicloudassist.user : Requis pour effectuer des requêtes vers les API Cloud Assist.

Étape 1 : S'authentifier auprès de Google Cloud

Le serveur MCP Gemini Cloud Assist utilise les identifiants par défaut de l'application locale (ADC) pour s'authentifier de manière sécurisée auprès de Google Cloud. Pour configurer les ADC, exécutez les commandes gcloud suivantes :

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

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

Configurer votre client MCP

La configuration de l'agent client dépend de l'agent que vous utilisez.

Gemini CLI

Installez le serveur MCP en tant qu'extension Gemini CLI :

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

Vous pouvez également ajouter manuellement la configuration à votre ~/.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

Ajoutez ce qui suit à votre 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. Dans votre projet Google Cloud, créez un ID client OAuth 2.0 pour une application de bureau.
2. Configurez URI://anysphere.cursor-mcp/oauth/callback comme URL de redirection.
3. Ajoutez ou fusionnez le bloc de configuration suivant :

{
  "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

Suivez les instructions de configuration pour votre application spécifique :

• Claude.ai

Outils MCP

Outils MCP Gemini Cloud Assist

Gemini Cloud Assist est un agent accessible via un ensemble d'outils MCP. L'agent invoqué par les appels d'outils MCP effectue ses propres appels d'outils en interne vers Google Cloud. Les outils MCP suivants sont publiés pour être consommés par les agents :

Outil	Description
ask_cloud_assist	L'interface principale pour l'assistance Google Cloud et pour l'agent Gemini Cloud Assist. Toutes les fonctionnalités sont accessibles via cet outil.
design_infra	Prend en charge les flux de travail pour la conception et l'architecture d'infrastructure sur Google Cloud.
investigate_issue	Prend en charge les flux de travail de dépannage dans Google Cloud. Peut effectuer un dépannage rapide ou un dépannage approfondi via une ressource d'investigation.
invoke_operation	Prend en charge les flux de travail pour la création, la mise à jour et la suppression de ressources dans Google Cloud. Fonctionnel uniquement lorsque les actions d'agent sont activées.
optimize_costs	Prend en charge les flux de travail pour l'analyse, le suivi et l'optimisation des coûts Google Cloud. Fournit des ventilations des dépenses et identifie les opportunités d'efficacité des coûts.

Outils MCP du Centre de conception d'applications

Les outils MCP du Centre de conception d'applications, souvent orchestrés par l'outil design_infra de GCA, gèrent le cycle de vie de l'application d'infrastructure à l'aide du Centre de conception d'applications, y compris la gestion des modèles, la conformité de sécurité, la remédiation et le déploiement.

Outil	Description
setup_adc	Initialise l'environnement du Centre de conception d'applications. Il s'agit d'une étape de configuration unique qui doit être effectuée avant que d'autres outils ADC puissent être utilisés.
manage_application	Gère le cycle de vie de déploiement d'une application. Utilisez cet outil pour déployer une conception vérifiée à l'aide du Centre de conception d'applications ou pour récupérer l'état et les détails d'un déploiement existant. C'est l'étape finale qui transforme votre conception en une infrastructure déployée sur Google Cloud.
manage_application_template	Gère le contenu Infrastructure as Code (IaC) de votre conception d'infrastructure. Utilisez-le pour enregistrer la conception en tant que modèle du Centre de conception d'applications, exporter la conception sous forme de fichiers Terraform ou mettre à jour la conception (par exemple, les configurations des composants, des paramètres, etc.).
assess_best_practices	Effectue un audit complet de sécurité et de configuration sur votre conception d'application avant le déploiement. Il valide la conception par rapport aux cadres et aux contrôles pertinents du Security Command Center, en renvoyant un rapport avec des résultats exploitables pour la remédiation.
list_application_templates	Répertorie toutes les conceptions d'applications disponibles.

Remarque : Ces outils ne doivent pas être traités comme des API stables. Les paramètres peuvent être renommés ou modifiés pour tenir compte des capacités évolutives de Gemini Cloud Assist.

Compétences de l'agent

Les outils MCP Gemini Cloud Assist exploitent des fichiers SKILL.md pour indiquer à votre agent comment utiliser correctement les outils. Les compétences aident à guider votre agent sur l'enchaînement de plusieurs outils dans un flux de travail, la transmission d'informations locales pertinentes à Gemini Cloud Assist et l'activation de l'invocation explicite.

Compétence	Description
designing-and-deploying-infrastructure	Guide l'agent sur la façon de concevoir, d'évaluer, de déployer et de dépanner l'infrastructure cloud à l'aide des outils du Centre de conception d'applications (ADC) et de Gemini Cloud Assist.
operating-google-cloud	Fournit des instructions pour la gestion des ressources Google Cloud Platform (GCP) et de Kubernetes à l'aide d'outils MCP spécialisés.

Contribuer

• Si vous rencontrez un bogue, veuillez signaler un problème sur notre page GitHub Issues.
• Avant d'envoyer une pull request, veuillez consulter notre Guide de contribution.

Licence

Ce projet est sous licence Apache 2.0 et fourni tel quel, sans garantie ni représentation pour quelque utilisation ou objectif que ce soit. Pour plus de détails, consultez le fichier LICENSE.