MCP Reference: maintenance.googleapis.com

Un servidor del Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA puede comprender.

Configuración del servidor

Debes habilitar los servidores de MCP y configurar la autenticación antes de usarlos. Para obtener más información sobre el uso de servidores de MCP remotos de Google y Google Cloud, consulta Descripción general de los servidores de MCP de Google Cloud.

Extremos del servidor

Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que usa una aplicación de IA (el host para el cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.

El servidor de MCP de la API de Maintenance tiene el siguiente extremo de MCP global:

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

Herramientas de MCP

Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.

Herramientas

El servidor de MCP de maintenance.googleapis.com tiene las siguientes herramientas:

Herramientas de MCP
list_resource_maintenances

Enumera los mantenimientos de recursos para una ubicación y un proyecto determinados.

Parámetros

  • parent (cadena, obligatorio): Es el elemento superior del mantenimiento de recursos, con el formato projects/{project}/locations/{location}.
  • page_size (entero, opcional): Es la cantidad máxima de mantenimientos de recursos que se enviarán por página.
  • page_token (cadena, opcional): Es un token de página, recibido de una llamada anterior a ListResourceMaintenances.
  • filter (cadena, opcional): Filtra la lista como se especifica en https://google.aip.dev/160.
  • order_by (cadena, opcional): Ordena los resultados como se especifica en https://google.aip.dev/132.

Valor que se muestra

El método muestra un objeto ListResourceMaintenancesResponse, que contiene lo siguiente:

  • resource_maintenances: Es una lista de mantenimientos de recursos que coinciden con los criterios de la solicitud.
  • next_page_token: Es un token que se puede enviar como page_token en una solicitud posterior para recuperar la siguiente página de resultados.

Notas

  • Usa '-' como ubicación para obtener una vista global en todas las regiones.
get_resource_maintenance

Recupera detalles sobre un mantenimiento de recursos específico.

Parámetros

  • name (cadena, obligatorio): Es el nombre de recurso del recurso dentro de un servicio, con el formato projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Valor que se muestra

El objeto de recurso ResourceMaintenance si se encuentra.
summarize_maintenances

Resume los mantenimientos para una ubicación y un proyecto determinados proporcionando estadísticas agregadas.

Parámetros

  • parent (cadena, obligatorio): Es el elemento superior del mantenimiento de recursos, con el formato projects/{project}/locations/{location}.
  • page_size (entero, opcional): Es la cantidad máxima de mantenimientos de recursos que se enviarán por página.
  • page_token (cadena, opcional): Es un token de página, recibido de una llamada anterior a SummarizeMaintenances.
  • filter (cadena, opcional): Filtra la lista como se especifica en https://google.aip.dev/160.
  • order_by (cadena, opcional): Ordena los resultados como se especifica en https://google.aip.dev/132.

Valor que se muestra

El método muestra un objeto SummarizeMaintenancesResponse, que contiene lo siguiente:

  • maintenances: Es una lista de resúmenes de mantenimiento.
  • next_page_token: Es un token que se puede enviar como page_token en una solicitud posterior para recuperar la siguiente página de resultados.

Notas

  • Usa '-' como ubicación para obtener un resumen global en todas las regiones.

Obtén especificaciones de herramientas de MCP

Para obtener las especificaciones de las herramientas de MCP para todas las herramientas de un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.

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