核心用法
gogcli-mcp 是一套 Google Workspace 自动化 MCP 服务器，通过封装 `gogcli` 工具，将 Docs、Sheets、Slides、Drive、Classroom 五大服务以标准化工具集暴露给 AI 助手。
架构与部署
采用「1+5」monorepo 结构：
- gogcli-mcp： umbrella 包，主聚焦 Sheets，同时暴露 Docs + Drive 辅助功能
- 独立子包：
gogcli-mcp-docs、gogcli-mcp-sheets、gogcli-mcp-slides、gogcli-mcp-drive、gogcli-mcp-classroom
每个子包以独立 npm 模块发布，可按需安装或全量部署。配置支持 npx 零安装启动，通过 GOG_ACCOUNT 环境变量实现多账户切换。
认证机制
依赖本地安装的 gogcli CLI 工具：
1. gogcli auth add 触发浏览器 OAuth 流程
2. 凭据本地存储，6 个 MCP 服务共享同一认证态
3. 多账户场景通过 GOG_ACCOUNT 显式指定
工具命名规范
各子包工具带专属前缀便于识别：
gog_docs_*— 文档创建、读取、编辑、查找替换、评论gog_sheets_*— 单元格、范围、公式、图表、命名范围gog_slides_*— 演示文稿与幻灯片创作gog_drive_*— 搜索、上传、下载、权限管理gog_classroom_*— 课程、作业、提交、花名册
显著优点
- 一站集成：单认证入口覆盖 Workspace 全生态，避免重复配置
- 灵活组合：子包独立发布，轻量场景可仅安装所需模块
- 生产就绪：npx 即时运行，零持久化依赖，适合 CI/CD 与容器环境
- 权限复用：继承 Google OAuth 细粒度授权，与 Workspace 原生安全策略对齐
潜在局限
- 外部依赖强：必须预装
gogcli并完成 OAuth，首次配置门槛高于纯 Node 实现 - 本地状态耦合：认证信息存储于本地 gogcli 账户，跨机器迁移需重新授权
- 调试透明度：工具错误透传自 gogcli 底层，复杂 API 错误需查阅原始工具文档
- 网络可达性：Workspace API 调用依赖稳定外网连接
适合人群
- 重度 Google Workspace 用户，希望用自然语言指令批量处理文档/表格/课程
- 教育行业工作者，需自动化作业批改、成绩统计、课件生成
- 企业办公自动化开发者，构建基于 AI 的报表流水线或文档审批流
- 已有 gogcli 使用基础，希望无缝接入 MCP 生态的技术团队
常规风险
- OAuth 泄露风险：
gogcli auth生成的本地令牌具备完整 Workspace 访问权限，共享机器需做好文件权限隔离 - 批量操作误伤：表格/文档的批量写入工具缺乏内置确认机制，自然语言指令歧义可能导致数据覆盖
- API 配额耗尽：高频自动化场景易触发 Google API 速率限制，需关注配额监控与退避策略
- 权限继承复杂性：Workspace 企业域的共享文档权限逻辑可能与子账户预期不符，跨域操作需谨慎验证 scope