MCP Reference: maintenance.googleapis.com

Um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos a um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores do MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Configuração do servidor

É necessário ativar os servidores do MCP e configurar a autenticação antes do uso. Para mais informações sobre como usar servidores do MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores do MCP do Google Cloud.

Endpoints do servidor

Um endpoint de serviço do MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor MCP que um aplicativo de IA (o host do cliente do MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do MCP do Google podem ser globais ou regionais.

O servidor MCP da API Maintenance tem o seguinte endpoint global do MCP:

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

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

Ferramentas

O servidor MCP maintenance.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
list_resource_maintenances

Lista as manutenções de recursos para um determinado projeto e local.

Parâmetros

  • parent (string, obrigatório): o principal da manutenção do recurso, no formato projects/{project}/locations/{location}.
  • page_size (inteiro, opcional): o número máximo de manutenções de recursos a serem enviadas por página.
  • page_token (string, opcional): um token de página recebido de uma chamada ListResourceMaintenances anterior.
  • filter (string, opcional): filtre a lista conforme especificado em https://google.aip.dev/160.
  • order_by (string, opcional): ordene os resultados conforme especificado em https://google.aip.dev/132.

Valor de retorno

O método retorna um objeto ListResourceMaintenancesResponse, que contém:

  • resource_maintenances: uma lista de manutenções de recursos que correspondem aos critérios da solicitação.
  • next_page_token: um token que pode ser enviado como page_token em uma solicitação subsequente para recuperar a próxima página de resultados.

Observações

  • Use '-' como local para uma visualização global em todas as regiões.
get_resource_maintenance

Recupera detalhes sobre uma manutenção de recurso específica.

Parâmetros

  • name (string, obrigatório): o nome do recurso em um serviço, no formato projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Valor de retorno

O objeto de recurso ResourceMaintenance, se encontrado.
summarize_maintenances

Resume as manutenções de um determinado projeto e local, fornecendo estatísticas agregadas.

Parâmetros

  • parent (string, obrigatório): o principal da manutenção do recurso, no formato projects/{project}/locations/{location}.
  • page_size (inteiro, opcional): o número máximo de manutenções de recursos a serem enviadas por página.
  • page_token (string, opcional): um token de página recebido de uma chamada SummarizeMaintenances anterior.
  • filter (string, opcional): filtre a lista conforme especificado em https://google.aip.dev/160.
  • order_by (string, opcional): ordene os resultados conforme especificado em https://google.aip.dev/132.

Valor de retorno

O método retorna um objeto SummarizeMaintenancesResponse, que contém:

  • maintenances: uma lista de resumos de manutenção.
  • next_page_token: um token que pode ser enviado como page_token em uma solicitação subsequente para recuperar a próxima página de resultados.

Observações

  • Use '-' como local para um resumo global em todas as regiões.

Receber especificações de ferramentas do MCP

Para receber as especificações de ferramentas do MCP de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no momento no servidor MCP.

Solicitação 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
}'