MCP Tools Reference: developerknowledge.googleapis.com

Tool: search_documents

Mit diesem Tool können Sie nach Dokumentation zu Google-Entwicklerprodukten suchen. Die Dokumente enthalten offizielle APIs, Code-Snippets, Versionshinweise, Best Practices, Leitfäden, Debugging-Informationen 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

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

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

  • Google Developers, Google Ads, Google Suche, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Dieses Tool gibt Textblöcke, Namen und URLs für übereinstimmende Dokumente zurück. Wenn die zurückgegebenen Blöcke nicht detailliert genug sind, um die Frage des Nutzers zu beantworten, verwenden Sie get_documents mit dem parent aus der Ausgabe dieses Tools, um den vollständigen Dokumentinhalt abzurufen.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool search_documents aufzurufen.

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 tool's MCP 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. Die vom Nutzer angegebene Rohabfrage, 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. Jedes Dokument in dieser Liste enthält einen Inhaltsschnipsel, der für die Suchanfrage relevant ist. Verwenden Sie das Feld „DocumentChunk.name“ 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 Blocks im Dokument. Die Block-ID ist innerhalb eines Dokuments eindeutig, aber nicht global eindeutig über alle Dokumente hinweg. Die Block-ID ist nicht stabil und kann sich im Laufe der Zeit ändern.

content

string

Nur Ausgabe. Der Inhalt des Dokumentblocks.

Toolanmerkungen

Toolanmerkungen 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 aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben der Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“ (wahr), ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“ (falsch).
  • destructiveHint: Wenn „true“ (wahr), kann das Tool destruktive Aktionen ausführen. Wenn „false“ (falsch), kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“ (wahr).
  • idempotentHint: Wenn „true“ (wahr), hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf seine Umgebung. Standardeinstellung: „false“ (falsch).
  • openWorldHint: Wenn „true“ (wahr), kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“ (falsch), kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise eine offene Welt, ein Tool für den Arbeitsspeicher jedoch nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌