MCP Tools Reference: drivemcp.googleapis.com

工具：create_file

调用此工具以创建文件或将文件上传到 Google 云端硬盘。

如果上传内容，请优先为文本内容使用“text_content”。对于非 UTF8 内容，请使用“base64_content”字段，并对数据进行 base64 编码以设置到该字段。

成功创建后，返回单个 File 对象。

以下 Google 云端硬盘第一方 MIME 类型可在不提供内容的情况下创建：

  • application/vnd.google-apps.document
  • application/vnd.google-apps.spreadsheet
  • application/vnd.google-apps.presentation

默认情况下，系统会针对以下 MIME 类型进行以下转换：

  • text/plain到application/vnd.google-apps.document
  • text/csv到application/vnd.google-apps.spreadsheet

如需针对第一方 MIME 类型停用转化，请将 disable_conversion_to_google_type 设置为 true。

通过将 MIME 类型设置为 application/vnd.google-apps.folder，可以创建文件夹。

上传内容时，必须填写 content_mime_type 字段，并且该字段应与上传的内容类型一致。

以下示例演示了如何使用 curl 调用 create_file MCP 工具。

Curl 请求 
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": "create_file",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

上传文件的请求。

CreateFileRequest

JSON 表示法 
{
  "title": string,
  "mimeType": string,
  "contentMimeType": string,
  "content": string,
  "base64Content": string,
  "textContent": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
字段
title

string

文件的标题。
mimeType

string

已弃用。请勿使用！请改用 content_mime_type。
contentMimeType

string

正在上传的内容的 MIME 类型。提供任何类型的内容时，此属性都是必需的。
content

string

以 base64 编码的文件内容。无论文件的 MIME 类型如何，内容字段都应始终采用 base64 编码。已弃用。请改用 base64_content 或 text_content。
base64Content

string

可选。要上传的 base64 编码内容。设置此属性和 text_content 属性会出错。
textContent

string

可选。要上传的 (UTF-8) 文本内容。设置此属性和 base64_content 属性会出错。
parentId

string

相应文件的父 ID。
disableConversionToGoogleType

boolean

设置为 true 可保留传入的内容 MIME 类型，而不转换为 Google 类型。例如，如果没有此参数，text/plain 内容 MIME 类型将转换为 application/vnd.google-apps.document。对于没有 Google 等效类型的类型，此属性无效。

输出架构

文件资源。

文件

JSON 表示法 
{
  "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
}
字段
id

string

所提取文件的 ID。
title

string

文件的标题。
parentId

string

文件的父级（可选）的 ID。

联合字段 _mime_type。

_mime_type 只能是下列其中一项：
mimeType

string

文件的 MIME 类型。

联合字段 _file_size。

_file_size 只能是下列其中一项：
fileSize

string (int64 format)

文件的大小（以字节为单位）。

联合字段 _description。

_description 只能是下列其中一项：
description

string

文件的说明。

联合字段 _file_extension。

_file_extension 只能是下列其中一项：
fileExtension

string

文件的原始文件扩展名，仅针对内容存储在云端硬盘中的文件填充此字段。

联合字段 _content_snippet。

_content_snippet 只能是下列其中一项：
contentSnippet

string

有关文件内容的生成的代码段。

联合字段 _view_url。

_view_url 只能是下列其中一项：
viewUrl

string

用于查看文件的网址。

联合字段 _shared_with_me_time。

_shared_with_me_time 只能是下列其中一项：
sharedWithMeTime

string (Timestamp format)

文件与请求者共享的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

联合字段 _created_time。

_created_time 只能是下列其中一项：
createdTime

string (Timestamp format)

文件的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

联合字段 _modified_time。

_modified_time 只能是下列其中一项：
modifiedTime

string (Timestamp format)

文件的最近修改时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

联合字段 _viewed_by_me_time。

_viewed_by_me_time 只能是下列其中一项：
viewedByMeTime

string (Timestamp format)

请求者最近一次查看文件的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

联合字段 _owner。

_owner 只能是下列其中一项：
owner

string

文件所有者的电子邮件地址。

联合字段 _can_add_children。

_can_add_children 只能是下列其中一项：
canAddChildren

boolean

请求者是否可以将子项添加到此文件夹。对于非文件夹类型，此值始终为 false。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

工具注释

破坏性提示：❌ | 等幂性提示：❌ | 只读提示：❌ | 开放世界提示：✅