MCP Tools Reference: developerknowledge.googleapis.com

工具：get_documents

使用這項工具，即可在單一呼叫中擷取單一文件或最多 20 份文件的完整內容。文件名稱應取自呼叫 search_documents 工具後傳回結果的 parent 欄位，或 answer_query 工具傳回的 references 欄位。將 names 參數設為文件名稱清單 (documents/...)，並在最終回覆中引用所用的權威來源文件。

以下程式碼範例說明如何使用 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

get_documents 的要求結構定義。

GetDocumentsRequest

JSON 表示法 
{
  "names": [
    string
  ]
}
欄位
names[]

string

必填。要擷取的文件名稱，由 search_documents 結果的 parent 欄位或 answer_query 的 references 欄位傳回。一次呼叫最多可擷取 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

ID。文件的資源名稱。格式：documents/{uri_without_scheme} 範例：documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

僅供輸出。內容的 URI，例如 https://cloud.google.com/storage/docs/creating-buckets。
content

string

僅供輸出。Markdown 格式的文件內容。
description

string

僅供輸出。文件說明。
title

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: ❌