MCP Tools Reference: developerknowledge.googleapis.com

Tool: search_documents

Mit diesem Tool können Sie Dokumentation zu Google-Entwicklerprodukten finden. Die Dokumente enthalten offizielle APIs, Code-Snippets, Versionshinweise, Best Practices, Leitfäden, Informationen zur Fehlerbehebung und mehr. Folgende Produkte und Domains werden abgedeckt:

  • 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 und docs.cloud.google.com

  • Google Developers, Ads, Suche, 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: web.dev

Dieses Tool gibt Textblöcke, Namen und URIs für übereinstimmende Dokumente zurück. Verwenden Sie search_documents gefolgt von get_documents, wenn Sie genaue Codebeispiele, CLI-Flags, bestimmte Fehlermeldungen, vollständige Anleitungen oder eine deterministische Keyword-Suche benötigen. Wenn die zurückgegebenen Chunks nicht detailliert genug sind, um die Frage des Nutzers zu beantworten, verwenden Sie get_documents mit der parent aus der Ausgabe dieses Tools, um den vollständigen Dokumentinhalt abzurufen. Geben Sie bei der Beantwortung der Nutzerfrage immer die Ressourcennamen (documents/...) oder URIs des maßgeblichen Quelldokuments an.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool search_documents aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfrageschema für search_documents. Verwenden Sie das Feld query, um nach zugehöriger Google-Entwicklerdokumentation zu suchen.

SearchDocumentChunksRequest

JSON-Darstellung 
{
  "query": string
}
Felder
query

string

Erforderlich. Der vom Nutzer bereitgestellte Rohabfragestring, z. B. „Wie erstelle ich einen Cloud Storage-Bucket?“.

Ausgabeschema

Antwortschema für search_documents.

SearchDocumentChunksResponse

JSON-Darstellung 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Felder
results[]

object (DocumentChunk)

Die Suchergebnisse für die angegebene Abfrage. Jeder DocumentChunk in dieser Liste enthält einen Ausschnitt des Inhalts, der für die Suchanfrage relevant ist. Verwenden Sie das Feld DocumentChunk.parent jedes Ergebnisses mit get_documents, um den vollständigen Dokumentinhalt abzurufen.

DocumentChunk

JSON-Darstellung 
{
  "parent": string,
  "id": string,
  "content": string
}
Felder
parent

string

Nur Ausgabe. Der Ressourcenname des Dokuments, aus dem dieser Block stammt. Format: documents/{uri_without_scheme}, Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Nur Ausgabe. Die ID dieses Chunks im Dokument. Die Chunk-ID ist innerhalb eines Dokuments eindeutig, aber nicht global über Dokumente hinweg. Die Chunk-ID ist nicht stabil und kann sich im Laufe der Zeit ändern.
content

string

Nur Ausgabe. Der Inhalt des Dokumentblocks.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können jedoch verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Websuchtool wäre beispielsweise ein Open-World-Tool, ein Speichertool dagegen nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Lesezugriff-Hinweis: ✅ | Open-World-Hinweis: ❌