AI导哈

Google文档MCP服务器

一个支持完整标签功能的Google文档MCP服务器，用于管理和操作文档中的标签内容。

  • by gigabrainobserver
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 gigabrainobserver/google-docs-mcp-server

使用说明

谷歌文档MCP服务器

A. 模型上下文协议 谷歌文档服务器 完全标签支持 --大多数现有服务器都会出错或完全跳过。

使用具有域范围委托的Google服务帐户，因此它可以在没有OAuth同意屏幕的工作区组织中工作。

它做什么

工具 说明
list_tabs 列出文档中的所有选项卡（包括嵌套选项卡）
read_document 以适当的标题级别标记一个或所有选项卡
get_document_info 轻量级元数据：标题、ID、链接、标签列表
create_document 使用可选的初始文本创建新文档
append_text 将文本附加到特定选项卡的末尾
insert_text 在选项卡中的字符索引处插入文本
replace_text 在选项卡（或整个文档）中查找和替换
batch_update 完全批量更新访问权限——格式化、表格、图像、样式
list_documents 按名称搜索驱动器中的文档

所有标签定位工具都接受 tab_id 或 tab_title 不区分大小写这 batch_update 刀具自动注射 tabId 进入请求，这样你就不必了。

为什么存在

Google Docs支持 标签页 自2024年底以来，但大多数MCP服务器要么：

  • 完全忽略标签页（只阅读第一个标签页）
  • 不使用 includeTabsContent=True，因此选项卡内容不可见
  • 不处理嵌套选项卡

此服务器正确处理所有这些，并将内容转换为具有适当标题结构的markdown。

安装

pip install google-docs-mcp-server

或者直接与 紫外线:

uvx google-docs-mcp-server

先决条件

  • Python 3.11+
  • 具有域范围授权的Google Cloud服务帐户

设置

1.创建GCP服务帐户

  1. 首选 谷歌云控制台 并创建（或选择）一个项目
  2. 启用 谷歌文档API 和 Google Drive API
  3. 在下创建服务帐户 IAM和管理>服务帐户
  4. 创建JSON密钥并下载

2.启用全域委派

  1. 在GCP的服务帐户详细信息页面上，启用 全域授权 并记下客户端ID
  2. 在 谷歌工作区管理员 >安全>API控制>域范围委派
  3. 添加具有以下作用域的客户端ID：
    https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive.readonly

3.配置您的MCP客户端

添加到MCP配置中（例如。 ~/.claude/mcp.json 或 .mcp.json):

{
  "mcpServers": {
    "google-docs": {
      "command": "uvx",
      "args": ["google-docs-mcp-server"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/your-service-account-key.json",
        "SUBJECT_EMAIL": "you@yourdomain.com"
      }
    }
  }
}

SUBJECT_EMAIL 是服务帐户模拟的工作区用户。

环境变量

变量 必填 描述
SERVICE_ACCOUNT_PATH 是 服务帐户JSON密钥文件的路径
SUBJECT_EMAIL 是 要模拟的工作区用户的电子邮件

许可证

麻省理工学院

相关 MCP