MCP Tools Reference: developerknowledge.googleapis.com

도구: get_documents

이 도구를 사용하여 단일 호출에서 단일 문서 또는 최대 20개의 문서의 전체 콘텐츠를 가져옵니다. 문서 이름은 search_documents 도구 호출 결과의 parent 필드에서 가져와야 합니다. names 매개변수를 문서 이름 목록으로 설정합니다.

다음 코드 샘플은 curl을 사용하여 get_documents MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

get_documents의 요청 스키마입니다.

GetDocumentsRequest

JSON 표현 
{
  "names": [
    string
  ]
}
필드
names[]

string

필수 항목입니다. search_documents에서 반환된 가져올 문서의 이름입니다. 한 번의 호출에서 최대 20개의 문서를 가져올 수 있습니다. 문서는 요청의 names와 동일한 순서로 반환됩니다. 형식: documents/{uri_without_scheme} 예: documents/docs.cloud.google.com/storage/docs/creating-buckets

출력 스키마

get_documents의 응답 스키마입니다.

GetDocumentsResponse

JSON 표현 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
필드
documents[]

object (Document)

요청된 문서입니다.

문서

JSON 표현 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
필드
name

string

식별자. 문서의 리소스 이름입니다. 형식: documents/{uri_without_scheme} 예: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

출력 전용입니다. https://cloud.google.com/storage/docs/creating-buckets와 같은 콘텐츠의 URI입니다.
content

string

출력 전용입니다. 마크다운 형식의 문서 콘텐츠입니다.
description

string

출력 전용입니다. 문서에 대한 설명입니다.
title

string

출력 전용입니다. 문서 제목입니다.

도구 주석

도구 주석은 지정된 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만 확인 메시지를 사용자에게 전송할 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true이면 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true이면 도구가 파괴적인 작업을 실행할 수 있습니다. false이면 도구가 추가 작업만 실행할 수 있습니다. 기본값: true.
  • idempotentHint: true이면 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true이면 도구가 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구가 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌