用途:通过 MCP 工具与 Google Drive 交互,完成搜索、读取、创建、整理、共享、评论和导出文件等操作。
主要能力:使用 Drive 文件 id 调用各工具;search 获取 id,也可用 list_folder 查已知文件夹、list_recent_files 查最近文件,或从用户粘贴的 URL 取 id。已知文件名时 exact_name 优于 query,可加 mime_type_filter 减少噪音。不得虚构 id 或复用过期会话中的 id,应先重新搜索。create_folder 接收 parent_folder_id,缺省则落在“我的云盘”根目录;用户指定目标文件夹时,先解析其 id 并传入。create_file 也支持 parent_folder_id,可直接创建到目标位置。Docs/Sheets/Slides 各自的 create 工具无法指定文件夹,需用 create_file 创建(Markdown 转 Doc、CSV 转 Sheet),或创建后用 move_or_rename 指定 destination_folder_id。move_or_rename 可同时移动和重命名,重命名不改 id。update_file 是同等的重命名/移动操作,使用 fileId、title、parentId 参数。授权范围为 drive.file,往本应用未创建且用户未选过的文件/文件夹写入可能返回 403,这是权限事实而非临时错误,不要重试。create_file 配合 target_mime_type: application/vnd.google-apps.document 可将 Markdown(标题、列表、表格)一次性转为 Google Doc;spreadsheet 可将 CSV 转为 Sheet;update_file_content 可原地转换。copy_file 可复制文件(可指定文件夹),适合实例化模板。get_file_metadata 返回完整记录,用于确认移动结果;get_file_permissions 列出访问者;share_file 向邮箱授予角色,仅在用户要求时共享。download_file 返回非 Google 文件(图片、PDF、纯文本)的 base64 原始字节。read_file 返回文本:Docs 转 Markdown、Sheets 按标签页转 CSV、Slides 转纯文本,可用于写后校验。export_file 返回渲染后字节的 base64:Docs/Sheets/Slides 可导出 pdf(Sheets PDF 渲染所有标签页和图表),Drawings 可导出 png/svg,还支持 docx/xlsx/pptx 等 Office 格式,导出上限 10 MB;单张幻灯片 PNG 应用 google-slides 的 get_slide_thumbnail。评论存储在 Drive 文件上,一套工具覆盖 Docs、Sheets、Slides:list_comments 返回评论文本、引用内容、解决状态和回复,需跟进 nextPageToken;add_comment 添加文件级评论;reply_to_comment 通过评论 id 回复,其 action: "resolve" 是解决线程的唯一方式,编辑文档文本不会解决评论。trash_file 可恢复(约 30 天),适用于文件和文件夹,不提供永久删除。创建和移动后,用 list_folder 或 get_file_metadata 确认位置;内容写入后,read_file 是文本的依据,export_file(pdf)是渲染结果的依据。
限制:授权为 drive.file,未授权文件可能 403;导出上限 10 MB;不提供永久删除;缺失信息暂未提供。