MCP Reference: maintenance.googleapis.com

Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione AI. I server MCP collegano le applicazioni AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione AI può comprendere.

Configurazione del server

Prima dell'uso, devi abilitare i server MCP e configurare l'autenticazione. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.

Endpoint server

Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (in genere un URL) del server MCP che un'applicazione AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint MCP di Google possono essere globali o regionali.

Il server MCP dell'API Maintenance ha il seguente endpoint MCP globale:

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

Strumenti MCP

Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.

Strumenti

Il server MCP maintenance.googleapis.com ha i seguenti strumenti:

Strumenti MCP
list_resource_maintenances

Elenca le manutenzioni delle risorse per un progetto e una località specifici.

Parametri

  • parent (stringa, obbligatorio): il parent della manutenzione della risorsa, nel formato projects/{project}/locations/{location}.
  • page_size (intero, facoltativo): il numero massimo di manutenzioni delle risorse da inviare per pagina.
  • page_token (stringa, facoltativa): un token di pagina, ricevuto da una precedente chiamata ListResourceMaintenances.
  • filter (stringa, facoltativa): filtra l'elenco come specificato in https://google.aip.dev/160.
  • order_by (stringa, facoltativa): ordina i risultati come specificato in https://google.aip.dev/132.

Valore restituito

Il metodo restituisce un oggetto ListResourceMaintenancesResponse, che contiene:

  • resource_maintenances: un elenco di manutenzioni delle risorse che corrispondono ai criteri della richiesta.
  • next_page_token: un token che può essere inviato come page_token in una richiesta successiva per recuperare la pagina successiva dei risultati.

Note

  • Utilizza "-" come località per una visualizzazione globale in tutte le regioni.
get_resource_maintenance

Recupera i dettagli di una manutenzione di una risorsa specifica.

Parametri

  • name (stringa, obbligatorio): il nome della risorsa all'interno di un servizio, nel formato projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Valore restituito

L'oggetto risorsa ResourceMaintenance, se trovato.
summarize_maintenances

Riassume le manutenzioni per un progetto e una località specifici fornendo statistiche aggregate.

Parametri

  • parent (stringa, obbligatorio): il parent della manutenzione della risorsa, nel formato projects/{project}/locations/{location}.
  • page_size (intero, facoltativo): il numero massimo di manutenzioni delle risorse da inviare per pagina.
  • page_token (stringa, facoltativa): un token di pagina, ricevuto da una precedente chiamata SummarizeMaintenances.
  • filter (stringa, facoltativa): filtra l'elenco come specificato in https://google.aip.dev/160.
  • order_by (stringa, facoltativa): ordina i risultati come specificato in https://google.aip.dev/132.

Valore restituito

Il metodo restituisce un oggetto SummarizeMaintenancesResponse, che contiene:

  • maintenances: un elenco di riepiloghi delle manutenzioni.
  • next_page_token: un token che può essere inviato come page_token in una richiesta successiva per recuperare la pagina successiva dei risultati.

Note

  • Utilizza "-" come località per un riepilogo globale in tutte le regioni.

Recuperare le specifiche degli strumenti MCP

Per recuperare le specifiche degli strumenti MCP per tutti gli strumenti in un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili nel server MCP.

Richiesta 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
}'