核心功能
gogcli-mcp 是一个 Google Workspace 自动化工具集,将 gogcli CLI 工具封装为 6 个独立的 MCP 服务器,覆盖完整的办公协作场景:
| 子包 | 核心能力 |
|------|---------|
| `gogcli-mcp` (umbrella) | Sheets 为主,兼含 Docs/Drive 辅助功能 |
| `gogcli-mcp-docs` | 文档创建、读取、编辑、查找替换、批注 |
| `gogcli-mcp-sheets` | 单元格/区域操作、公式、图表、命名范围 |
| `gogcli-mcp-slides` | 演示文稿与幻灯片创建编辑 |
| `gogcli-mcp-drive` | 文件搜索、上传下载、权限管理 |
| `gogcli-mcp-classroom` | 课程、作业、提交、花名册管理 |
显著优势
- 统一认证:6 个包共享单次 OAuth 登录(
gogcli auth add),多账户可通过GOG_ACCOUNT环境变量切换 - 按需安装:各子包独立发布为 npm 模块,可按场景选择性部署
- 零配置启动:支持
npx -y直接运行,无需本地克隆 - 工具前缀隔离:
gog_docs_*、gog_sheets_*等命名空间避免冲突
局限性与风险
- 外部依赖:必须预装
gogcli二进制且完成浏览器 OAuth 流程,无法纯离线使用 - PATH 敏感:若
gogcli不在系统 PATH 需手动设置GOG_PATH - 权限粒度:继承 Google API 的 OAuth 作用域,敏感操作(如 Classroom 成绩修改)需额外授权确认
- 无沙箱隔离:工具直接调用用户本地 gogcli 凭据,多用户场景存在账户混淆风险
适用人群
- 需要 AI 助手直接操作 Google 文档/表格的知识工作者
- 构建教育自动化工作流的教师/教育机构
- 希望将 Google Workspace 集成到本地 MCP 生态的开发者
安全建议
建议在 mcpServers 配置中显式设置 GOG_ACCOUNT 锁定账户,避免默认账户误操作;生产环境应配合 Google Workspace 管理员审计日志监控。