MCP Reference: cloudcli.googleapis.com

Le serveur MCP Google Cloud CLI fournit des outils permettant d'exécuter des commandes Google Cloud CLI dans un environnement de bac à sable à distance.

Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.

Configuration du serveur

Vous devez activer les serveurs MCP et configurer l'authentification avant de les utiliser. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.

Points de terminaison du serveur

Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.

Le serveur MCP de l'API Cloud CLI Execution possède le point de terminaison MCP global suivant :

  • https://cloudcli.googleapis.com/mcp

Outils MCP

Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.

Outils

Le serveur MCP cloudcli.googleapis.com dispose des outils suivants :

Outils MCP
run_gcloud_command

Exécute une seule commande gcloud CLI dans le projet Google Cloud de l'utilisateur.

AVERTISSEMENT DE SÉCURITÉ CRITIQUE (POTENTIELLEMENT DESTRUCTEUR) : Cet outil peut créer, mettre à jour ou supprimer des ressources Google Cloud (par exemple, gcloud compute instances delete). Il ne se limite PAS aux commandes en lecture seule. Soyez extrêmement prudent.

COMMANDES INTERDITES : un agent NE DOIT PAS exécuter les commandes gcloud suivantes (y compris leurs variantes alpha/bêta) : app deploy, app instances ssh, auth, billing, components, config, docker, feedback, info, init, meta, survey.

RÈGLES D'EXÉCUTION STRICTES :

  1. Vous DEVEZ fournir le paramètre "project" (c'est-à-dire project="projects/PROJECT_ID") lorsque vous utilisez cet outil (il est utilisé pour la vérification de l'activation de l'API Cloud CLI Execution, la facturation, le quota, etc.). Il ne s'agit PAS de la même chose que l'option "--project" des commandes gcloud, qui permet de spécifier le projet sur lequel gcloud fonctionne.
  2. Mise en forme des options : vous devez toujours utiliser le signe "=" pour séparer les clés d'option de leurs valeurs pour toutes les options longues. Correct : --zone=us-central1-a ou --project=my-project. Incorrect : --zone us-central1-a ou --project my-project.
  3. Projet de facturation : vous ne pouvez pas supposer que des paramètres de facturation ou de projet préconfigurés sont présents dans l'environnement d'exécution. Pour les commandes non limitées à un projet (par exemple, au niveau d'un dossier ou d'une organisation) ou pour des scénarios spécifiques tels que Cloud Storage Requester Pays, vous DEVEZ transmettre l'indicateur --billing-project=PROJECT. Pour les commandes à portée de projet, vous POUVEZ également spécifier --billing-project=PROJECT pour remplacer le projet de quota, ce qui prendra effet pour les API Google Cloud qui ne prennent pas en charge le remplacement du projet de ressource.
  4. Portée du projet : vous DEVEZ TOUJOURS transmettre le flag --project=PROJECT_ID pour les commandes de portée projet. Ne l'utilisez pas pour les commandes au niveau de l'organisation ou du dossier. Si vous ne fournissez pas de --project flag pour une commande à portée de projet, le projet de ressource sera défini par défaut sur le projet défini dans le flag --billing-project.
  5. Si vous spécifiez l'indicateur --billing-project dans la commande gcloud, assurez-vous que la valeur est un ID du projet ou un numéro de projet. La valeur ne DOIT PAS être une valeur spéciale (c'est-à-dire LEGACY, CURRENT_PROJECT, CURRENT_PROJECT_WITH_FALLBACK).
  6. Vous DEVEZ spécifier au moins l'une des valeurs suivantes : --project ou --billing-project dans la chaîne de commande.
  7. Opérations asynchrones : pour les opérations synchrones de longue durée (par exemple, la création d'une VM ou d'une base de données), vous DEVEZ TOUJOURS transmettre l'indicateur --async pour éviter les délais d'attente de l'agent.
  8. Limitation du débit de journaux : lorsque vous utilisez gcloud logging read, vous DEVEZ TOUJOURS inclure un indicateur --limit (par exemple, --limit=100) pour éviter les délais d'expiration des identifiants et des connexions.
  9. Autocorrection : si une commande renvoie une erreur, analysez stderr, corrigez la syntaxe ou les indicateurs, puis réessayez lors de l'itération suivante.
  10. input_files : (facultatif) liste des fichiers à créer dans l'environnement avant d'exécuter la commande. Chaque fichier doit comporter un "chemin" (relatif au répertoire actuel) et un "contenu". Le contenu doit être du texte brut représentant le contenu du fichier. Cela est utile pour les commandes qui lisent des fichiers (par exemple, gcloud builds submit --config=cloudbuild.yaml --async --project=PROJECT_ID).

Exemples de commandes/schémas gcloud :

  1. Lire les journaux d'instance Compute Engine avec un niveau de gravité >=ERROR : gcloud logging read "severity>=ERROR AND resource.type='gce_instance'" --limit=10 --order=DESC --project=PROJECT_ID
    • Notez l'utilisation de guillemets pour l'expression de filtre.
  2. Répertoriez tous les points de terminaison PSC : gcloud compute forwarding-rules list --project=PROJECT_ID
  3. Décrivez un point de terminaison PSC : gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region=REGION --project=PROJECT_ID
    • Notez l'utilisation de "=" pour le flag --region.
  4. Répertorier tous les clusters : gcloud container clusters list --project=PROJECT_ID
  5. Décrire un cluster : gcloud container clusters describe CLUSTER_NAME --region=REGION --project=PROJECT_ID
  6. Listez les instances de calcul : gcloud compute instances list --project=PROJECT_ID
  7. Obtenir la stratégie IAM pour un projet : gcloud projects get-iam-policy PROJECT_ID --project=PROJECT_ID

Par défaut, les chaînes de réponse sont mises en forme pour la sortie du terminal (stdout ou stderr). Utilisez l'option "--format" pour modifier le format.
run_bq_command

Exécute une seule commande de la CLI BigQuery (bq). Cet outil vous permet d'exécuter n'importe quelle commande bq dans le projet de l'utilisateur, y compris les commandes qui créent, mettent à jour ou suppriment des ressources Google Cloud (c'est-à-dire les mutations).

AVERTISSEMENT DE SÉCURITÉ CRITIQUE (POTENTIELLEMENT DESTRUCTEUR) : cet outil peut créer, mettre à jour ou supprimer des ressources BigQuery (par exemple, bq rm, bq cancel, bq query). Il n'est PAS limité aux commandes en lecture seule. Soyez extrêmement prudent.

COMMANDES INTERDITES : un agent NE DOIT PAS exécuter les commandes bq suivantes : bq init, bq pyshell, bq shell.

RÈGLES D'EXÉCUTION STRICTES :

  1. Vous DEVEZ spécifier au moins l'une des valeurs suivantes : --project_id ou --quota_project_id dans la chaîne de commande.
  2. ID de projet vs projet de quota : l'indicateur --project_id spécifie le projet de ressources sur lequel la commande s'applique (il est identique à l'indicateur --project de gcloud). L'indicateur --quota_project_id spécifie le projet facturé pour la facturation/le quota de l'appel d'API BigQuery en aval (il reflète l'indicateur --billing-project de gcloud). Si --project_id est spécifié dans la commande, il sera utilisé comme projet de facturation/de quota. Si --project_id n'est pas spécifié OU si --quota_project_id est également spécifié, le projet de facturation/de quota sera celui défini dans l'option --quota_project_id.
  3. Mise en forme des options : vous devez toujours utiliser le signe "=" pour séparer les clés d'option de leurs valeurs pour toutes les options longues. Correct : '--project_id=my-project' ou '--location=us'. Incorrect : '--project_id my-project' ou '--location us'. N'utilisez pas d'espaces entre les indicateurs et leurs valeurs.
  4. Aucune configuration par défaut : la commande bq est exécutée de manière apatride. Elle ne charge pas les fichiers de configuration locaux tels que .bigqueryrc. Par conséquent, pour toutes les opérations régionales (par exemple, la création d'un ensemble de données ou l'interrogation d'un ensemble de données régional), vous DEVEZ spécifier explicitement l'indicateur --location (par exemple, --location=us ou --location=EU).
  5. Opérations asynchrones : certaines commandes lancent des opérations synchrones de longue durée (par exemple, l'exécution de jobs de requête). Vous DEVEZ TOUJOURS transmettre l'indicateur --nosync pour ces commandes afin d'éviter les délais d'attente de l'agent.
  6. Restrictions concernant les commandes : vous NE DEVEZ PAS utiliser les commandes bq suivantes : bq init, bq pyshell, bq shell. Le piping ou l'enchaînement de commandes ne sont PAS acceptés.
  7. Autocorrection : si une commande renvoie une erreur, analysez stderr, corrigez la syntaxe ou les indicateurs, puis réessayez lors de l'itération suivante.

Voici quelques exemples de commandes bq mutantes : bq mk, bq rm, bq update, bq insert, bq query (sans --dry_run), etc. Utilisation : RunBq(command="bq query --project_id=PROJECT_ID 'SELECT 1'", project="projects/PROJECT_ID", input_files=[{"path": "PATH", "contents": "CONTENTS"}]) Vous DEVEZ fournir la commande bq complète sous forme de chaîne unique dans le paramètre "command". Vous DEVEZ fournir le paramètre "project" (format : projects/PROJECT_ID) en tant que projet d'exécution de l'API pour les vérifications de la facturation, de l'activation de l'API et de la consommation de quota.

Exemples de commandes/schémas bq :

  1. Exécutez une requête : bq query --use_legacy_sql=false --project_id=PROJECT_ID 'SELECT * FROMproject.dataset.tableLIMIT 10'
  2. Créez un ensemble de données : bq mk --dataset --location=us --project_id=PROJECT_ID myDataset
  3. Créer un tableau : bq mk --table --project_id=PROJECT_ID myDataset.myTable name:string,value:integer
  4. Supprimer un ensemble de données : bq rm -f --dataset --project_id=PROJECT_ID myDataset
  5. Supprimer un tableau : bq rm -f -t --project_id=PROJECT_ID myDataset.myTable
  6. Mettre à jour la description de la table : bq update --description="New description" --project_id=PROJECT_ID myDataset.myTable
  7. Lister les ensembles de données d'un projet : bq ls --datasets=true --project_id=PROJECT_ID

Obtenir les spécifications de l'outil MCP

Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.

Requête curl 
curl --location 'https://cloudcli.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'