AI工具接入教程
每日 MCP Server

Google Drive MCP：让 LLM 读写 Google Docs/Sheets/Drive 的官方服务器

2026-08-02
文件仓库
支持客户端：
Claude CodeCursorVS CodeContinueCline
MCPGoogle Drive云存储Google Workspace

简介

Google Drive MCP 是 ModelContextProtocol 官方维护的云存储集成服务器，通过 Google Drive API 让 LLM 客户端能够搜索文件、读取内容、创建文档、上传资源。一条 npx 命令即可让 Claude Code、Cursor、VS Code 等 MCP 客户端成为 Google Workspace 助理。本文梳理核心能力、OAuth 凭证申请、各客户端配置与实战注意事项。

安装命令

npx -y @modelcontextprotocol/server-google-drive

简介

Google Drive MCP 是 ModelContextProtocol 官方仓库维护的云存储集成服务器。它把 Google Drive API 包装为 MCP 工具，让任何兼容 MCP 的客户端都能通过统一协议操作 Google Workspace，无需各自实现 OAuth 流程、无需维护 token 刷新、无需处理 API 限流。

对重度使用 Google 生态的用户而言，这意味着：让 AI 助理直接帮你"搜一下我 Drive 里去年的季度报告"、"读取那张 Sheets 的销售数据"、"把这段总结写入我的 Notes 文档"。

核心能力

工具名用途关键参数
gdrive_search搜索文件与文件夹query、page_size（默认 10）、mime_type 过滤
gdrive_get_file读取文件内容（含 Docs/Sheets）file_id
gdrive_get_file_metadata获取文件元信息file_id
gdrive_create_file创建新文件name、content、mime_type、parent_id
gdrive_update_file更新已有文件内容file_id、content
gdrive_list_folder列出文件夹内容folder_id、page_size
gdrive_upload_file上传本地文件parent_id、filename、file_data

支持的特殊 mime type：

  • application/vnd.google-apps.document（Google Docs）
  • application/vnd.google-apps.spreadsheet（Google Sheets）
  • application/vnd.google-apps.presentation（Google Slides）
  • application/pdf、text/plain、application/vnd.openxmlformats-officedocument.wordprocessingml.document（.docx）

申请 Google OAuth 凭证

步骤 1：创建 Google Cloud 项目

  1. 访问 https://console.cloud.google.com/
  2. 顶部选择项目 → 新建项目 → 命名（如 mcp-drive）

步骤 2：启用 Google Drive API

  1. 进入 APIs & Services → Library
  2. 搜索 Google Drive API → Enable

步骤 3：配置 OAuth 同意屏幕

  1. 进入 APIs & Services → OAuth consent screen
  2. 选择 External → 填写 App 名称、邮箱
  3. 在 Scopes 中添加：
    • https://www.googleapis.com/auth/drive.file（推荐：仅访问应用创建或打开的文件）
    • https://www.googleapis.com/auth/drive.metadata.readonly（读取文件元信息）
    • 如需全量访问：https://www.googleapis.com/auth/drive（敏感权限需审核）
  4. 添加测试用户：填入你的 Google 账号邮箱

步骤 4：创建 OAuth 客户端凭证

  1. 进入 APIs & Services → Credentials → Create Credentials → OAuth client ID
  2. 选择 Desktop app（MCP 是本地进程，不是 Web 服务）
  3. 创建后下载 JSON 文件，重命名为 gdrive-oauth-credentials.json

步骤 5：首次运行完成 OAuth 授权

首次启动 MCP 服务器会触发 OAuth 流程：

  1. 控制台打印授权 URL
  2. 浏览器打开 → 用 Google 账号登录 → 同意
  3. 返回的 code 自动写入 ~/.mcp/gdrive-oauth-token.json
  4. 后续运行自动复用 token，过期自动刷新

各客户端配置示例

Claude Code（CLI）

编辑 ~/.claude/claude_desktop_config.json：

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-drive"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS_PATH": "/path/to/gdrive-oauth-credentials.json"
      }
    }
  }
}

首次启动后浏览器会弹出授权页，授权完成后即可使用。

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-drive"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS_PATH": "/path/to/gdrive-oauth-credentials.json"
      }
    }
  }
}

VS Code（Continue 插件）

编辑 ~/.continue/config.json：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-google-drive"]
        },
        "env": {
          "GOOGLE_OAUTH_CREDENTIALS_PATH": "/path/to/gdrive-oauth-credentials.json"
        }
      }
    ]
  }
}

Cline 插件

通过 Cline: MCP Settings 命令打开 cline_mcp_settings.json，结构与 Claude Desktop 一致。

实战场景

场景 1：让 Claude Code 做"会议纪要助理"

读取我 Drive 里标题包含「2026 Q3 产品评审」的 Google Doc，
提取所有 action item，
新建一个 Google Sheet 记录这些 item，列：任务 / 负责人 / 截止日期。

Claude Code 会调用 gdrive_search → gdrive_get_file（Doc）→ 解析 → gdrive_create_file（Sheet）。

场景 2：让 Cursor 做"季度报告生成器"

搜索我 Drive 里 2026 年 Q2 的所有 Google Sheets（按文件名匹配 "2026-Q2-*"），
读取每个 Sheet 的第一个工作表，
汇总成一份 Markdown 报告，保存为新 Google Doc。

配合 Cursor 的代码执行能力，可批量处理多个 Sheet。

场景 3：让 VS Code 做"技术文档归档员"

读取当前工作区的 README.md 和 docs/ 目录下所有 .md 文件，
分别上传到我 Drive 的「项目文档」文件夹，
文件名保持原名。

Cline + Continue 可循环调用 gdrive_upload_file 完成批量上传。

场景 4：跨文档信息检索

搜索我 Drive 里所有 Google Docs，
找出提到「OKR」的文档，
整理成表格：文件名 / 修改时间 / 上下文片段。

gdrive_search 支持完整 Google Drive 搜索语法（title:、type:、owner:、before:、after:）。

与本地 Filesystem MCP 的对比

维度Google Drive MCPFilesystem MCP
存储位置云端本地磁盘
跨设备访问✅❌
协作能力✅ 多人共享❌
离线可用❌✅
大文件处理慢（受 API 限流）快
OAuth 复杂度高（需配置凭证）无
适用场景文档协作、跨设备代码工程、本地脚本

建议两者都装：Filesystem MCP 管代码与脚本，Google Drive MCP 管文档与协作。

注意事项

  1. 凭证保密：gdrive-oauth-credentials.json 和 gdrive-oauth-token.json 切勿提交到 Git。前者含 client secret，后者含 refresh token，泄露后他人可冒充你访问 Drive。
  2. Scope 选择：优先用 drive.file（仅应用创建/打开的文件），避免申请 drive（全量访问）触发 Google 审核。
  3. Quota 限制：Google Drive API 默认每天 1,000,000,000 次查询，但每秒每用户 1000 次。MCP 服务器已内置退避，但仍建议避免循环调用。
  4. OAuth Token 过期：refresh token 默认 7 天过期（测试用户），生产应用需通过 Google 审核。token 过期后需重新授权。
  5. 大文件读取：gdrive_get_file 对超过 10MB 的文件会截断，建议用 gdrive_get_file_metadata 先判断大小。
  6. Sheets 特殊处理：Google Sheets 返回的是 JSON（网格数据），不是 CSV。MCP 服务器已自动转 Markdown 表格，但复杂公式可能丢失。
  7. 共享驱动器：My Drive 与 Shared Drive 的 API 行为略有差异，搜索时需用 includeItemsFromAllDrives: true。
  8. 中文文件名：Google Drive API 完全支持 UTF-8，但 Windows 上 MCP 客户端可能有编码问题，建议终端设为 UTF-8。

安全建议

  • 最小权限原则：只申请实际需要的 Scope，优先 drive.file 而非 drive
  • 文件夹白名单：在 Prompt 中限定 AI 只能操作特定文件夹，防止误删
  • 操作审计：让 AI 在每次创建/更新文件前先在本地日志记录
  • 测试用户：开发期用测试账号，不要用主账号授权
  • 凭证轮换：每 90 天在 Google Cloud Console 重新生成 OAuth 凭证

小结

Google Drive MCP 是 Google Workspace 用户最直接的 AI 文档入口：一次 OAuth 授权、一份凭证文件，就能让任意 MCP 客户端读写 Drive。对于需要"搜索文档、读取内容、创建报告、上传文件"的办公场景，几乎是必装组件。建议搭配 Filesystem MCP（管理本地代码）和 Slack MCP（消息协同）组成企业办公三件套。

下一篇我们会讲 Notion MCP，看如何让 LLM 读写 Notion 数据库与页面。

相关推荐

查看更多 →
MCP云存储

Google Drive MCP：让 AI 读写云盘，打通云端文件流

Google Drive MCP 让 Claude/Cursor 直连 Google Drive，搜文件、读内容、建文件夹、上传文件，让 AI 把散落云盘的文档变成可调用的云端文件流。本文拆解安装配置、6 个工具用法、5 个实战场景（跨文档检索、会议纪要归档、批量整理、合同提取、协作分发），以及只读与写权限的安全管控。

2026-08-18
#MCP#Google Drive
MCP编程开发

MCP Resources 实战：让服务端把 8 万行设计文档喂给 Agent，附四套客户端配置与13 行排查表

Tools 是「Agent 问你答」，Resources 是「你问Agent 答」——同一个 MCP Server 里，方向相反的两种能力，而且很多人在写 Server 时只实现了 Tools，漏掉了 Resources。结果是文档、规范、schema、日志这类只读数据只能靠 Agent 一个个调 Tool 去捞，每次捞都要过一次模型判断，成本高还不稳定。本文讲透MCP 四大原语里的第二个：Resources。涵盖 resources/list、resources/read、resources/templates/list 三个方法与 URI 模板机制（RFC 6570 展开规则），以及 Resource 与 Tool 的选型对照（把同一份数据做成 Tool 还是 Resource 的实测差异）。给出一个可运行的「设计文档中心」Server 完整实现（含 40+ 行 TypeScript，含分页、版本快照、访问审计），以及 Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置 JSON。三个实战场景：Agent 读设计文档回答「这个接口为什么这么设计」、按版本读取历史 schema 做迁移校验、把资源目录挂进 IDE 侧边栏。另含资源数量膨胀到 500+ 时的分页与 URI 命名规范、五条安全红线（为什么资源 URI 绝不能暴露绝对路径和凭据），以及 13 行故障排查表。

2026-10-13
#MCP#Model Context Protocol
MCP开发

MCP Elicitation 实战：让服务端在缺参数时反向向用户提问——受限 Schema 设计 + 四套客户端配置 + 13 行排查表

写 MCP Server 的人迟早会遇到一个尴尬场景：工具必填参数用户没给，服务端要么猜一个（猜错就出事），要么返回一个干巴巴的「缺少参数 xx」让 Agent 自己去追问（Agent 经常追问得驴唇不对马嘴）。MCP 协议里的 Elicitation 就是为这个场景设计的第三个「反向能力」——服务端可以在执行过程中主动向客户端发起一次提问，由客户端把问题渲染成表单弹给用户，用户填完再回传，全程服务端不需要自己实现任何 UI、不需要存任何凭据。本文讲透它的机制与边界：elicitation/create 请求的完整结构、为什么 requestedSchema 被刻意限制成只支持原始类型（这是安全设计不是能力不足）、用户的三种响应（accept / decline / cancel）各自的语义差异、以及最关键的——为什么不能在 Elicitation 里索取密码和 API Key。含 TypeScript SDK 完整实现（含类型定义与降级路径）、Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置、三个实战场景（部署确认 / 缺失参数补全 / 敏感操作二次确认）、与 Sampling / 传统参数校验的选型对比、六条安全注意事项，以及 13 行故障排查表。

2026-10-12
#MCP#Model Context Protocol
MCP开发

MCP Roots 与 Sampling 实战：让服务端主动划边界、反向要推理——四套客户端配置 + 14 行排查表

多数人写 MCP Server 只用到 Resources / Tools / Prompts 三项，Roots 和 Sampling 这两个反向能力基本闲置，结果就是 Server 既不知道自己该在哪干活，也没有推理能力。本文把这两个方向的能力讲透：Roots 是客户端告诉服务端「工作区边界在哪」的机制（URI 列表、roots/list 双向协商、listChanged 动态通知、路径穿越的必修防御），Sampling 是服务端反过来向客户端的 LLM 请求一次推理的机制（服务端不知道任何 API Key，模型由客户端挑、账由客户端付、人可以卡在中间审批）。含 TypeScript SDK 完整实现代码（含 sampling/createMessage 的类型定义与 human-in-the-loop 回调）、Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置、三个实战场景（单仓守卫 / 日志归因摘要 / 隐私脱敏代理）、与其他方案的选型对比表、六条安全注意事项，以及 14 行故障排查表。

2026-10-10
#MCP#Model Context Protocol