MCP Reference: maintenance.googleapis.com

모델 컨텍스트 프로토콜 (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
}'