核心功能与用法
gogcli-mcp 是一个基于 MCP（Model Context Protocol）协议的 Google Workspace 自动化工具集，采用单体仓库（Monorepo）架构封装了 6 个独立的服务器模块：
| 模块 | 功能覆盖 |
|------|----------|
| `gogcli-mcp` | 总入口，Sheets 为主，含部分 Docs/Drive 辅助功能 |
| `gogcli-mcp-docs` | Google Docs 的创建、读取、编辑、查找替换、评论管理 |
| `gogcli-mcp-sheets` | 单元格、区域、公式、图表、命名范围操作 |
| `gogcli-mcp-slides` | 演示文稿及幻灯片创作 |
| `gogcli-mcp-drive` | 文件搜索、上传、下载、权限管理 |
| `gogcli-mcp-classroom` | 课程、作业、提交、花名册管理 |
使用前提：需先安装 `gogcli` 命令行工具，执行 gogcli auth add 完成浏览器 OAuth 授权，所有 6 个子服务共享同一认证凭据。
部署方式：支持按需安装（推荐生产环境）或全量 umbrella 安装（快速验证）。通过 npx -y 直接运行，无需本地持久化安装。
显著优点
1. 统一认证架构：一次 OAuth 授权，6 个服务共享，避免重复配置
2. 模块化按需加载：可按业务场景选择安装，减少依赖体积
3. 原生 MCP 协议：与 Claude、Cursor 等 AI IDE 无缝集成
4. 完整 Workspace 覆盖：从文档协作到课堂管理，覆盖企业办公全场景
潜在局限与风险
- 前置依赖重：必须预装 gogcli 二进制并完成 OAuth，入门门槛高于纯 Node 实现
- 环境变量敏感：
GOG_ACCOUNT需正确配置，多账号场景易混淆 - 权限粒度粗：依赖 Google API 的 OAuth 权限范围，无法细粒度限制到单文件
- 网络稳定性：Google API 在国内访问受限，需配合代理或海外环境
适合人群
- 已深度使用 Google Workspace 的企业团队
- 需将 AI 助手接入现有文档工作流的开发者
- 教育行业需自动化 Classroom 管理的教师/管理员
常规风险提示
- OAuth token 存储于本地机器，共享设备需格外注意安全
- 批量操作（如全 Drive 搜索）可能触发 Google API 速率限制
- 建议配合
GOG_PATH显式指定 gogcli 路径，避免 PATH 污染导致执行失败