MCP Tools Reference: drivemcp.googleapis.com

Tool: read_file_content

Rufen Sie dieses Tool auf, um eine Darstellung einer Drive-Datei in natürlicher Sprache und optional die Kommentare abzurufen.

Bei sehr großen Dateien ist der Dateiinhalt möglicherweise unvollständig. Die Textdarstellung ändert sich im Laufe der Zeit. Gehen Sie daher nicht von einem bestimmten Format des von diesem Tool zurückgegebenen Texts aus. Sofern unterstützt, werden Kommentartags in den Inhalt aufgenommen.

Unterstützte MIME-Typen:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

Wenn die Datei nicht gefunden wird, versuchen Sie es mit anderen Tools wie search_files, um die vom Nutzer angeforderte Datei anhand von Keywords zu finden.

Im folgenden Beispiel wird gezeigt, wie Sie curl verwenden, um das MCP-Tool read_file_content aufzurufen.

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

Eingabeschema

Anfrage zum Lesen von Dateiinhalten mit Unterstützung für das Abrufen von Kommentaren.

ReadFileContentRequest

JSON-Darstellung 
{
  "fileId": string,
  "includeComments": boolean
}
Felder
fileId

string

Erforderlich. Die ID der abzurufenden Datei.
includeComments

boolean

Gibt an, ob Kommentare in die Antwort aufgenommen werden sollen. Kommentare werden in den Textinhalt der Datei eingefügt und den Kommentarthreads zugeordnet.

Ausgabeschema

Antwort zum Lesen von Dateiinhalten.

ReadFileContentResponse

JSON-Darstellung 
{
  "contentAnchoredComments": [
    {
      object (CommentThread)
    }
  ],
  "unanchoredComments": [
    {
      object (CommentThread)
    }
  ],

  "fileContent": string

  "textFormattingNotSupported": boolean
  // End of list of possible types for union field
  // _text_formatting_not_supported.

  "commentsNotSupported": boolean
}
Felder
contentAnchoredComments[]

object (CommentThread)

Kommentarthreads, auf die im zurückgegebenen `file_content` verwiesen wird.
unanchoredComments[]

object (CommentThread)

Kommentarthreads, die nicht an bestimmten Inhalt in der zurückgegebenen Datei angehängt werden konnten.

Union-Feld _file_content.

Für _file_content ist nur einer der folgenden Werte zulässig:
fileContent

string

Drive-Dateiinhalt im Textformat. Kann leer sein, wenn die Datei nicht für die Textformatierung unterstützt wird. Kann Kommentarreferenzen enthalten, wenn `include_comments` in der Anfrage auf „true“ gesetzt ist.

Union-Feld _text_formatting_not_supported.

Für _text_formatting_not_supported ist nur einer der folgenden Werte zulässig:
textFormattingNotSupported

boolean

Gibt an, ob die Textformatierung für diese Datei unterstützt wird. Wenn „true“, ist `file_content` leer.

Union-Feld _comments_not_supported.

Für _comments_not_supported ist nur einer der folgenden Werte zulässig:
commentsNotSupported

boolean

Gibt an, ob das Zurückgeben von Kommentaren für diese Datei unterstützt wird. Ist nur vorhanden, wenn `include_comments` in der Anfrage auf „true“ gesetzt ist und Kommentare nicht unterstützt werden.

CommentThread

JSON-Darstellung 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
Felder
replies[]

object (Post)

Die Antworten auf den ersten Beitrag im Kommentarthread.

Union-Feld _comment_id.

Für _comment_id ist nur einer der folgenden Werte zulässig:
commentId

string

Die ID des Kommentarthreads. Dies ist dieselbe ID wie der ursprüngliche Kommentar.

Union-Feld _status.

Für _status ist nur einer der folgenden Werte zulässig:
status

enum (Status)

Der Status des Kommentarthreads.

Union-Feld _head_post.

Für _head_post ist nur einer der folgenden Werte zulässig:
headPost

object (Post)

Der erste Beitrag im Kommentarthread.

Post

JSON-Darstellung 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
Felder

Union-Feld _post_id.

Für _post_id ist nur einer der folgenden Werte zulässig:
postId

string

Die ID des Beitrags.

Union-Feld _content.

Für _content ist nur einer der folgenden Werte zulässig:
content

string

Der Inhalt des Beitrags.

Union-Feld _author_name.

Für _author_name ist nur einer der folgenden Werte zulässig:
authorName

string

Der Name des Autors des Beitrags.

Union-Feld _modified_time.

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

string (Timestamp format)

Der Zeitpunkt, zu dem der Beitrag zuletzt geändert 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".

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 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 ist der Nanosekundenanteil der Dauer und 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.

Status

Definiert den Status eines Kommentarthreads.

Enums
STATUS_UNSPECIFIED
OPEN
RESOLVED

Toolanmerkungen

Destruktiv: ❌ | Idempotent: ✅ | Schreibgeschützt: ✅ | Offene Welt: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly