MCP Tools Reference: drivemcp.googleapis.com

Tool: search_files

Mit einer strukturierten Anfrage (Syntax: query_term operator values) nach Drive-Dateien suchen. Klauseln mit and, or, not und Klammern kombinieren. String-Werte müssen in einfache Anführungszeichen gesetzt werden. Eingebettete Anführungszeichen müssen mit \' maskiert werden.

Suchbegriffe und Operatoren:

  • title (ops: contains, =, !=) – Dateititel
  • fullText (ops: contains) – Titel oder Anzeigentext
  • mimeType (ops: contains, =, !=) – MIME-Typ
  • modifiedTime, viewedByMeTime, createdTime (ops: <=, <, =, !=, >, >=). Verwenden Sie RFC 3339 UTC, z.B. 2012-06-04T12:00:00-08:00. Datentypen nicht vergleichbar.
  • parentId (ops: =, !=). Verwenden Sie 'root' für die Ablage des Nutzers.
  • owner (Betriebsteam: =, !=). Verwenden Sie 'me' für den anfragenden Nutzer.
  • sharedWithMe (Betriebsteam: =, !=). Werte: true oder false.

Andere Operatoren: and, or, not.

Beispiele:

  • title contains 'hello' and title contains 'goodbye'
  • modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/')
  • parentId = '1234567'
  • fullText contains 'hello'
  • owner = 'test@example.org'
  • sharedWithMe = true
  • owner = 'me' für Dateien, die dem Nutzer gehören

Verwenden Sie next_page_token für die Paginierung. Eine leere Antwort bedeutet, dass keine weiteren Ergebnisse vorhanden sind.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool search_files aufrufen.

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

Eingabeschema

Anfrage zum Suchen von Dateien

SearchFilesRequest

JSON-Darstellung 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Felder
query

string

Die Suchanfrage.

Union-Feld _page_token.

Für _page_token ist nur einer der folgenden Werte zulässig:
pageToken

string

Das Seitentoken für die Paginierung.

Union-Feld _page_size.

Für _page_size ist nur einer der folgenden Werte zulässig:
pageSize

integer

Die maximale Anzahl von Dateien, die auf jeder Seite zurückgegeben werden sollen.

Union-Feld _exclude_content_snippets.

Für _exclude_content_snippets ist nur einer der folgenden Werte zulässig:
excludeContentSnippets

boolean

Wenn „true“, wird der Inhalts-Snippet aus der Antwort ausgeschlossen.

Ausgabeschema

Antwort auf die Suche nach Dateien.

SearchFilesResponse

JSON-Darstellung 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
Felder
files[]

object (File)

Nur Ausgabe. Die Liste der Dateien.

Union-Feld _next_page_token.

Für _next_page_token ist nur einer der folgenden Werte zulässig:
nextPageToken

string

Das Token für die nächste Seite.

Datei

JSON-Darstellung 
{
  "id": string,
  "title": string,
  "parentId": string,

  "mimeType": string

  "fileSize": string

  "description": string

  "fileExtension": string

  "contentSnippet": string

  "viewUrl": string

  "sharedWithMeTime": string

  "createdTime": string

  "modifiedTime": string

  "viewedByMeTime": string

  "owner": string

  "canAddChildren": boolean
}
Felder
id

string

Die ID der abgerufenen Datei.
title

string

Der Titel der Datei.
parentId

string

Die (optionale) ID des übergeordneten Elements der Datei.

Union-Feld _mime_type.

Für _mime_type ist nur einer der folgenden Werte zulässig:
mimeType

string

Der MIME-Typ der Datei.

Union-Feld _file_size.

Für _file_size ist nur einer der folgenden Werte zulässig:
fileSize

string (int64 format)

Die Größe der Datei in Byte.

Union-Feld _description.

Für _description ist nur einer der folgenden Werte zulässig:
description

string

Die Beschreibung der Datei.

Union-Feld _file_extension.

Für _file_extension ist nur einer der folgenden Werte zulässig:
fileExtension

string

Die ursprüngliche Dateiendung der Datei. Dieses Feld wird nur für Dateien mit in Drive gespeicherten Inhalten ausgefüllt.

Union-Feld _content_snippet.

Für _content_snippet ist nur einer der folgenden Werte zulässig:
contentSnippet

string

Generiertes Snippet zum Inhalt der Datei.

Union-Feld _view_url.

Für _view_url ist nur einer der folgenden Werte zulässig:
viewUrl

string

Die URL zum Aufrufen der Datei.

Union-Feld _shared_with_me_time.

Für _shared_with_me_time ist nur einer der folgenden Werte zulässig:
sharedWithMeTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Datei für den Anfragenden freigegeben wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _created_time.

Für _created_time ist nur einer der folgenden Werte zulässig:
createdTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Datei erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _modified_time.

Für _modified_time ist nur einer der folgenden Werte zulässig:
modifiedTime

string (Timestamp format)

Der Zeitpunkt der letzten Änderung der Datei.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _viewed_by_me_time.

Für _viewed_by_me_time ist nur einer der folgenden Werte zulässig:
viewedByMeTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Datei zuletzt vom Antragsteller aufgerufen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _owner.

Für _owner ist nur einer der folgenden Werte zulässig:
owner

string

Die E‑Mail-Adresse des Inhabers der Datei.

Union-Feld _can_add_children.

Für _can_add_children ist nur einer der folgenden Werte zulässig:
canAddChildren

boolean

Gibt an, ob der Antragsteller diesem Ordner Kinder hinzufügen kann. Für Typen, die keine Ordner sind, ist dieser Wert immer „false“.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌