Drive MCP 表格助手

为什么需要这个技能

把大模型接入 Google Drive 时，常见痛点是：Drive 文件搜索与读取没有统一接口，Google Sheets 的单元格编辑要单独写逻辑；即使找到 mcp-gdrive，也要手动处理 OAuth 授权、项目配置、环境变量和构建步骤，链路长且容易卡在鉴权上。这个技能把 mcp-gdrive 封装为可直接引用的技能，让支持 MCP 的助手能用统一接口完成 Drive 搜索/读取和 Sheets 编辑，减少重复对接。

它如何工作

核心能力分为两层：

• Google Drive 文件访问：按名称或内容搜索文件，读取文本类文件内容，适合快速定位文档并交给助手处理。
• Google Sheets 编辑：读取电子表格数据，定位单元格或区域，并通过 Google Sheets API 写入/更新单元格，适合报表补录、数据清洗后回填等场景。

关键执行路径是：准备 Google Cloud 项目，启用 Google Drive API、Google Sheets API、Google Docs API，并配置 OAuth 桌面客户端凭据；启动 node ./dist/index.js 触发认证，在浏览器中完成授权；之后由 MCP 客户端调用 Drive 搜索/读取与 Sheets 更新工具。注意要用 npm run build 或 npm run watch 构建服务端。

适用边界与注意点

• 需要 Node.js、npm、MCP 兼容客户端，以及 Google Cloud 项目与 OAuth 桌面客户端凭据。
• 必须把 Client ID、Client Secret 和配置目录作为环境变量提供；认证账号需与 Google Cloud 项目同组织。
• OAuth Consent Screen 可先用 internal 测试；生产使用前要按实际访问范围收紧权限。
• Sheets 编辑以单元格/区域写入为主，复杂公式重算、批量事务或跨表一致性仍建议配合官方 API 或额外脚本校验。
• Drive 读取受文件权限和 OAuth scope 限制；大文件、二进制文件和协作冲突场景需要额外处理。