MCP Reference: maintenance.googleapis.com

Ein Model Context Protocol-Server (MCP-Server) fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung versteht.

Server einrichten

Sie müssen MCP-Server aktivieren und die Authentifizierung einrichten, bevor Sie sie verwenden können. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Übersicht über Google Cloud-MCP-Server.

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über die eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Er ist der Ansprechpartner für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google-MCP-Endpunkte können global oder regional sein.

Der MCP-Server der Maintenance API hat den folgenden globalen MCP-Endpunkt:

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

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Verfügung stellt, um eine Aktion in der realen Welt auszuführen.

Tools

Der MCP-Server maintenance.googleapis.com hat die folgenden Tools:

MCP-Tools
list_resource_maintenances

Listet Ressourcenwartungen für ein bestimmtes Projekt und einen bestimmten Standort auf.

Parameter

  • parent (String, erforderlich): Das übergeordnete Element der Ressourcenwartung im Format projects/{project}/locations/{location}.
  • page_size (Ganzzahl, optional): Die maximale Anzahl von Ressourcenwartungen, die pro Seite gesendet werden sollen.
  • page_token (String, optional): Ein Seitentoken, das von einem vorherigen ListResourceMaintenances-Aufruf empfangen wurde.
  • filter (String, optional): Filtert die Liste wie unter https://google.aip.dev/160 angegeben.
  • order_by (String, optional): Sortiert die Ergebnisse wie unter https://google.aip.dev/132 angegeben.

Rückgabewert

Die Methode gibt ein ListResourceMaintenancesResponse-Objekt zurück, das Folgendes enthält:

  • resource_maintenances: Eine Liste von Ressourcenwartungen, die den Anfragekriterien entsprechen.
  • next_page_token: Ein Token, das in einer nachfolgenden Anfrage als page_token gesendet werden kann, um die nächste Ergebnisseite abzurufen.

Hinweise

  • Verwenden Sie „-“ als Standort für eine globale Ansicht aller Regionen.
get_resource_maintenance

Ruft Details zu einer bestimmten Ressourcenwartung ab.

Parameter

  • name (String, erforderlich): Der Ressourcenname der Ressource in einem Dienst im Format projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Rückgabewert

Das ResourceMaintenance-Ressourcenobjekt, falls gefunden.
summarize_maintenances

Fasst Wartungen für ein bestimmtes Projekt und einen bestimmten Standort zusammen, indem aggregierte Statistiken bereitgestellt werden.

Parameter

  • parent (String, erforderlich): Das übergeordnete Element der Ressourcenwartung im Format projects/{project}/locations/{location}.
  • page_size (Ganzzahl, optional): Die maximale Anzahl von Ressourcenwartungen, die pro Seite gesendet werden sollen.
  • page_token (String, optional): Ein Seitentoken, das von einem vorherigen SummarizeMaintenances-Aufruf empfangen wurde.
  • filter (String, optional): Filtert die Liste wie unter https://google.aip.dev/160 angegeben.
  • order_by (String, optional): Sortiert die Ergebnisse wie unter https://google.aip.dev/132 angegeben.

Rückgabewert

Die Methode gibt ein SummarizeMaintenancesResponse-Objekt zurück, das Folgendes enthält:

  • maintenances: Eine Liste von Wartungszusammenfassungen.
  • next_page_token: Ein Token, das in einer nachfolgenden Anfrage als page_token gesendet werden kann, um die nächste Ergebnisseite abzurufen.

Hinweise

  • Verwenden Sie „-“ als Standort für eine globale Zusammenfassung aller Regionen.

MCP-Tool-Spezifikationen abrufen

Verwenden Sie die Methode tools/list, um die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abzurufen. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

cURL-Anfrage 
                      
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
}'