MCP Reference: maintenance.googleapis.com

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

サーバーの設定

使用する前に、MCP サーバーを有効にして 認証を設定する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法については、Google Cloud MCP サーバーの概要をご覧ください。

サーバー エンドポイント

MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。

Maintenance API MCP サーバーには、次のグローバル MCP エンドポイントがあります。

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

MCP ツール

MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。

ツール

maintenance.googleapis.com MCP サーバーには、次のツールがあります。

MCP ツール
list_resource_maintenances

指定されたプロジェクトとロケーションのリソース メンテナンスを一覧表示します。

パラメータ

  • parent（文字列、必須）: リソース メンテナンスの親。形式は projects/{project}/locations/{location} です。
  • page_size（整数、省略可）: ページごとに送信するリソース メンテナンスの最大数。
  • page_token（文字列、省略可）: 前回の ListResourceMaintenances 呼び出しから受け取ったページトークン。
  • filter（文字列、省略可）: https://google.aip.dev/160 で指定されているとおりにリストをフィルタします。
  • order_by（文字列、省略可）: https://google.aip.dev/132 で指定されているとおりに結果を並べ替えます。

戻り値

このメソッドは、次のものを含む ListResourceMaintenancesResponse オブジェクトを返します。

  • resource_maintenances: リクエスト条件に一致するリソース メンテナンスのリスト。
  • next_page_token: 後続のリクエストで page_token として送信して、結果の次のページを取得できるトークン。

注

  • すべてのリージョンでグローバル ビューを表示するには、ロケーションとして「-」を使用します。
get_resource_maintenance

特定のリソース メンテナンスの詳細を取得します。

パラメータ

  • name（文字列、必須）: サービス内のリソースのリソース名。形式は projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id} です。

戻り値

見つかった場合は ResourceMaintenance リソース オブジェクト。
summarize_maintenances

集計された統計情報を提供することで、指定されたプロジェクトとロケーションのメンテナンスを要約します。

パラメータ

  • parent（文字列、必須）: リソース メンテナンスの親。形式は projects/{project}/locations/{location} です。
  • page_size（整数、省略可）: ページごとに送信するリソース メンテナンスの最大数。
  • page_token（文字列、省略可）: 前回の SummarizeMaintenances 呼び出しから受け取ったページトークン。
  • filter（文字列、省略可）: https://google.aip.dev/160 で指定されているとおりにリストをフィルタします。
  • order_by（文字列、省略可）: https://google.aip.dev/132 で指定されているとおりに結果を並べ替えます。

戻り値

このメソッドは、次のものを含む SummarizeMaintenancesResponse オブジェクトを返します。

  • maintenances: メンテナンスの概要のリスト。
  • next_page_token: 後続のリクエストで page_token として送信して、結果の次のページを取得できるトークン。

注

  • すべてのリージョンでグローバルな概要を表示するには、ロケーションとして「-」を使用します。

MCP ツールの仕様を取得する

MCP サーバー内のすべてのツールの MCP ツール仕様を取得するには、tools/list メソッドを使用します。次の例では、curl を使用して、MCP サーバー内で現在使用可能なすべてのツールとその仕様を一覧表示する方法を示します。

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