Gemini Cloud Assist

Serveur MCP Gemini Cloud Assist

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

[!WARNING] Avis de dépréciation et migration vers un serveur MCP distant

Le serveur MCP Gemini Cloud Assist a migré d'une architecture Node.js locale vers une architecture de serveur MCP distant. L'ancien serveur Node.js local ne sera plus pris en charge dans les prochains mois.

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 à des versions antérieures.

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

[!NOTE] Les Conditions d'utilisation de la plateforme Google Cloud (disponibles à https://cloud.google.com/terms/) et les Conditions de traitement des données et de sécurité (disponibles à 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éez et architectez des configurations d'infrastructure pour Google Cloud.
• Résoudre les problèmes : Effectuez des investigations approfondies pour trouver la cause racine de problèmes complexes dans votre environnement Google Cloud.
• Gérer les ressources : Créez, mettez à jour et supprimez des ressources Google Cloud directement depuis votre flux de chat (nécessite Agent Actions).
• Optimiser les coûts : Analysez vos dépenses, suivez les coûts et identifiez les opportunités d'efficacité telles que les ressources inactives.
• Obtenir une assistance générale : Posez des questions et obtenez des conseils sur les bonnes pratiques, architectures et opérations 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 aux 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 (ADC) locaux pour s'authentifier de manière sécurisée auprès de Google Cloud. Pour configurer 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 du client-agent dépend de l'agent que vous utilisez.

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 identifiant 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 que les agents puissent les consommer :

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 résolution de problèmes dans Google Cloud. Peut effectuer un dépannage rapide ou un dépannage plus 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. Fonctionne uniquement lorsque Agent Actions est activé.
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 Application Design Center

Les outils Application Design Center MCP, souvent orchestrés par l'outil design_infra de GCA, gèrent le cycle de vie des applications d'infrastructure à l'aide d'Application Design Center, y compris la gestion des modèles, la conformité et la correction de sécurité, ainsi que le déploiement.

Outil	Description
setup_adc	Initialise l'environnement Application Design Center. Il s'agit d'une étape de configuration unique qui doit être effectuée avant que les 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 d'Application Design Center ou récupérer le statut et les détails d'un déploiement existant. Il s'agit de l'étape finale qui transforme votre conception en 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 Application Design Center, exporter la conception sous forme de fichiers Terraform, ou mettre à jour la conception (par exemple, composant, configurations de 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 contrôles pertinents de Security Command Center, renvoyant un rapport avec des conclusions exploitables pour la correction.
list_application_templates	Liste toutes les conceptions d'application 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 les fichiers SKILL.md pour instruire votre agent sur la manière d'utiliser correctement les outils. Les compétences aident à guider votre agent pour enchaîner plusieurs outils dans un flux de travail, transmettre des informations locales pertinentes à Gemini Cloud Assist et activer l'invocation explicite.

Compétence	Description
designing-and-deploying-infrastructure	Guide l'agent sur la façon de concevoir, évaluer, déployer et résoudre les problèmes d'infrastructure cloud à l'aide des outils Application Design Center (ADC) et Gemini Cloud Assist.
operating-google-cloud	Fournit des instructions pour gérer les ressources Google Cloud Platform (GCP) et Kubernetes à l'aide d'outils MCP spécialisés.

Contribuer

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

Licence

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