MCP Reference: maintenance.googleapis.com

Model Context Protocol (MCP) 服务器充当外部服务（为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能）与 LLM 或 AI 应用之间的代理。MCP 服务器将 AI 应用连接到数据库和 Web 服务等外部系统，并将这些系统的响应转换为 AI 应用可理解的格式。

服务器设置

您必须先启用 MCP 服务器并设置身份验证，然后才能使用。如需详细了解如何使用 Google 和 Google Cloud 远程 MCP 服务器，请参阅 Google Cloud MCP servers overview。

服务器端点

MCP 服务端点是 MCP 服务器的网络地址和通信接口（通常是网址），AI 应用（MCP 客户端的宿主）使用该端点来建立安全、标准化的连接。它是 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
}'