使用说明

@node2flow/google-docs mcp

MCP服务器 谷歌文件 --通过模型上下文协议，使用26个工具创建、读取、编辑、格式化和管理文档。

快速开始

克劳德桌面/光标

添加到MCP配置中：

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@node2flow/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

HTTP模式

GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=xxx GOOGLE_REFRESH_TOKEN=xxx npx @node2flow/google-docs-mcp --http

MCP端点： http://localhost:3000/mcp

Cloudflare工作人员

可用网址： https://google-docs-mcp-community.node2flow.net/mcp

POST https://google-docs-mcp-community.node2flow.net/mcp?GOOGLE_CLIENT_ID=xxx&GOOGLE_CLIENT_SECRET=xxx&GOOGLE_REFRESH_TOKEN=xxx

工具（26）

文件（2）

工具	说明
`gdoc_create`	创建带有标题的新文档
`gdoc_get`	获取文档内容、结构、页眉、页脚

内容（5）

工具	说明
`gdoc_insert_text`	在特定位置插入文本
`gdoc_delete_content`	删除某个范围内的内容
`gdoc_replace_all_text`	查找并替换所有事件
`gdoc_insert_inline_image`	从URL插入图像
`gdoc_insert_page_break`	插入分页符

文本格式（2）

工具	说明
`gdoc_update_text_style`	粗体、斜体、下划线、字体、颜色、链接
`gdoc_update_paragraph_style`	对齐、间距、标题、缩进

列表（2）

工具	说明
`gdoc_create_bullets`	创建项目符号或编号列表
`gdoc_delete_bullets`	从段落中删除项目符号

表（7）

工具	说明
`gdoc_insert_table`	插入新表
`gdoc_insert_table_row`	向表中添加行
`gdoc_insert_table_column`	向表中添加列
`gdoc_delete_table_row`	删除表行
`gdoc_delete_table_column`	删除表列
`gdoc_merge_table_cells`	合并表格中的单元格
`gdoc_unmerge_table_cells`	取消合并以前合并的单元格

页眉和页脚（4）

工具	说明
`gdoc_create_header`	创建文档标题
`gdoc_create_footer`	创建文档页脚
`gdoc_delete_header`	删除标题
`gdoc_delete_footer`	删除页脚

章节和命名范围（3）

工具	说明
`gdoc_insert_section_break`	插入分节符（下一页或连续页）
`gdoc_create_named_range`	创建一个命名范围来为内容添加书签
`gdoc_delete_named_range`	删除命名范围（保留内容）

高级（1）

工具	说明
`gdoc_batch_update`	任何操作组合的原始批更新

指标体系

Google Docs使用基于0的字符索引：

Index 0    → Document root (not usable for content)
Index 1    → Start of body content
Index N    → End of body (from gdoc_get response)

重要：总是打电话 gdoc_get 首先要找到当前的指数。进行多次编辑时，从 从结束到开始 以避免指数变动。

配置

参数	必填	说明
`GOOGLE_CLIENT_ID`	是	来自谷歌云控制台的OAuth 2.0客户端ID
`GOOGLE_CLIENT_SECRET`	是	OAuth 2.0客户端密码
`GOOGLE_REFRESH_TOKEN`	是	刷新令牌（通过OAuth同意流获得）

获取您的凭据

首选谷歌云控制台
创建项目→ 启用 谷歌文档API
创建 OAuth 2.0客户端ID （桌面应用程序类型）
使用 OAuth游乐场或者您的应用程序获取具有作用域的刷新令牌 https://www.googleapis.com/auth/documents

OAuth范围

范围	访问
`documents`	完全读/写访问
`documents.readonly`	只读访问

许可证

MIT许可证-请参阅许可证