核心功能
gogcli-mcp-docs 是基于 gogcli 构建的 Google Docs MCP 服务器，提供30个专用工具，涵盖三大能力矩阵：
基础文档操作（7项）：创建、读取、更新、删除文档，支持纯文本和原始JSON两种读取模式。
增强编辑工具（11项）：包括追加内容（gog_docs_append）、流式正则替换（gog_docs_sed）、精准位置插入/更新（gog_docs_insert/update）、范围删除（gog_docs_delete）、文档复制与移至回收站。
导出与格式（8项）：支持导出为PDF、TXT、HTML、DOCX、RTF、ODT、EPUB七种格式；字符/段落级格式化（gog_docs_format）；完整的评论生命周期管理（列表、获取、添加、回复、解决、删除）。
认证体系：5个专用认证工具处理Google OAuth流程。
显著优点
- Markdown原生支持：
gog_docs_append可直接渲染Markdown表格、列表，减少API调用次数 - 类Unix操作体验：
sed风格的正则替换降低学习成本 - 细粒度权限：通过标准Google OAuth_scope控制，非服务账号模式更安全
- 多标签页支持：适配Google Docs最新的标签页架构
潜在局限
- 上游依赖风险：核心功能依赖gogcli，若上游停止维护将受影响
- Markdown转换缺陷：表格处理存在三个已知bug（3+表格乱序、单元格内格式符转义失败、空表头泄漏），需手动规避
- Node版本门槛：要求Node.js 18+，旧环境需升级
适用人群
- 需要自动化文档工作流的团队（法务合同、技术文档、会议纪要）
- 构建AI写作助手的开发者（通过MCP协议集成）
- 迁移自Microsoft Word/Google Workspace脚本的老用户
常规风险
- OAuth令牌泄露：需妥善保管
GOG_ACCOUNT环境变量 - 批量操作不可逆：
sed替换和范围删除无预览模式，建议先read备份 - Rate Limiting：Google Docs API默认配额100请求/100秒，高频场景需申请提升