MCP Tools Reference: developerknowledge.googleapis.com

도구: search_documents

이 도구를 사용하여 Google Developers 제품에 관한 문서를 찾습니다. 문서에는 공식 API, 코드 스니펫, 출시 노트, 권장사항, 가이드, 디버깅 정보 등이 포함되어 있습니다. 다음 제품 및 도메인을 다룹니다.

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com 및 docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, Youtube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • 웹: web.dev

이 도구는 일치하는 문서의 텍스트, 이름, URI 청크를 반환합니다. 정확한 코드 샘플, CLI 플래그, 특정 오류 메시지, 전체 튜토리얼 둘러보기 또는 결정론적 키워드 조회가 필요한 경우 search_documents 다음에 get_documents를 사용하는 것이 좋습니다. 반환된 청크가 사용자의 질문에 답변할 만큼 충분히 상세하지 않은 경우 이 도구의 출력에서 parent와 함께 get_documents를 사용하여 전체 문서 콘텐츠를 검색합니다. 사용자에게 답변할 때는 항상 공신력 있는 소스 문서 리소스 이름 (documents/...) 또는 URI를 인용하세요.

다음 코드 샘플은 curl를 사용하여 search_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": "search_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

search_documents의 요청 스키마입니다. query 필드를 사용하여 관련 Google 개발자 문서를 검색합니다.

SearchDocumentChunksRequest

JSON 표현 
{
  "query": string
}
필드
query

string

필수 항목입니다. 사용자가 제공한 원시 쿼리 문자열입니다(예: 'Cloud Storage 버킷을 만드는 방법').

출력 스키마

search_documents의 응답 스키마입니다.

SearchDocumentChunksResponse

JSON 표현 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
필드
results[]

object (DocumentChunk)

지정된 쿼리의 검색 결과입니다. 이 목록의 각 DocumentChunk에는 검색어와 관련된 콘텐츠 스니펫이 포함되어 있습니다. get_documents과 함께 각 결과의 DocumentChunk.parent 필드를 사용하여 전체 문서 콘텐츠를 가져옵니다.

DocumentChunk

JSON 표현 
{
  "parent": string,
  "id": string,
  "content": string
}
필드
parent

string

출력 전용입니다. 이 청크가 속한 문서의 리소스 이름입니다. 형식: documents/{uri_without_scheme} 예: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

출력 전용입니다. 문서 내 이 청크의 ID입니다. 청크 ID는 문서 내에서 고유하지만 문서 간에 전역적으로 고유하지는 않습니다. 청크 ID는 안정적이지 않으며 시간이 지남에 따라 변경될 수 있습니다.
content

string

출력 전용입니다. 문서 청크의 콘텐츠입니다.

도구 주석

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

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

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

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌