MCP Reference: maintenance.googleapis.com

Un serveur Model Context Protocol (MCP) fait office de proxy entre un service externe qui fournit le contexte, les données ou les 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 du LLM pour demander un contexte, appeler un outil ou accéder à une ressource. Les points de terminaison MCP Google peuvent être globaux ou régionaux.

Le serveur MCP de l'API Maintenance possède le point de terminaison MCP global suivant :

  • https://maintenance.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 maintenance.googleapis.com possède les outils suivants :

Outils MCP
list_resource_maintenances

Répertorie les maintenances de ressources pour un projet et un emplacement donnés.

Paramètres

  • parent (chaîne, obligatoire) : parent de la maintenance de la ressource, au format projects/{project}/locations/{location}.
  • page_size (entier, facultatif) : nombre maximal de maintenances de ressources à envoyer par page.
  • page_token (chaîne, facultatif) : jeton de page reçu d'un appel ListResourceMaintenances précédent.
  • filter (chaîne, facultatif) : filtre la liste comme spécifié dans https://google.aip.dev/160.
  • order_by (chaîne, facultatif) : trie les résultats comme spécifié dans https://google.aip.dev/132.

Valeur renvoyée

La méthode renvoie un objet ListResourceMaintenancesResponse, qui contient les éléments suivants :

  • resource_maintenances : liste des maintenances de ressources correspondant aux critères de la requête.
  • next_page_token : jeton qui peut être envoyé en tant que page_token dans une requête ultérieure pour récupérer la page de résultats suivante.

Remarques

  • Utilisez "-" comme emplacement pour une vue globale dans toutes les régions.
get_resource_maintenance

Récupère des informations sur une maintenance de ressource spécifique.

Paramètres

  • name (chaîne, obligatoire) : nom de la ressource dans un service, au format projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Valeur renvoyée

Objet de ressource ResourceMaintenance s'il est trouvé.
summarize_maintenances

Récapitule les maintenances d'un projet et d'un emplacement donnés en fournissant des statistiques agrégées.

Paramètres

  • parent (chaîne, obligatoire) : parent de la maintenance de la ressource, au format projects/{project}/locations/{location}.
  • page_size (entier, facultatif) : nombre maximal de maintenances de ressources à envoyer par page.
  • page_token (chaîne, facultatif) : jeton de page reçu d'un appel SummarizeMaintenances précédent.
  • filter (chaîne, facultatif) : filtre la liste comme spécifié dans https://google.aip.dev/160.
  • order_by (chaîne, facultatif) : trie les résultats comme spécifié dans https://google.aip.dev/132.

Valeur renvoyée

La méthode renvoie un objet SummarizeMaintenancesResponse, qui contient les éléments suivants :

  • maintenances : liste des récapitulatifs de maintenance.
  • next_page_token : jeton qui peut être envoyé en tant que page_token dans une requête ultérieure pour récupérer la page de résultats suivante.

Remarques

  • Utilisez "-" comme emplacement pour un récapitulatif global dans toutes les régions.

Obtenir les spécifications des outils 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 répertorier tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.

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