Strato MCP Gdocs Suite

平流层MCP GDocs套件

一个Python MCP服务器，它将谷歌文档、谷歌表格、谷歌幻灯片和谷歌表单作为任何兼容MCP的人工智能助手的工具。目前支持 26工具 跨文档、电子表格、演示文稿和表单。

先决条件

在您的Google Cloud项目中启用这些API：

1. 谷歌文档API
2. 谷歌网页API
3. 谷歌幻灯片API
4. Google Drive API
5. 谷歌表单API

然后创建OAuth凭据：

1. 首选 APIs & Services -> OAuth consent screen 并对其进行配置
2. 在OAuth同意屏幕上，转到 范围 并添加以下范围：

- https://www.googleapis.com/auth/documents - https://www.googleapis.com/auth/spreadsheets - https://www.googleapis.com/auth/presentations - https://www.googleapis.com/auth/drive.readonly - https://www.googleapis.com/auth/forms.body - https://www.googleapis.com/auth/forms.responses.readonly

1. 首选 APIs & Services -> Credentials -> Create credentials -> OAuth client ID -> Desktop app
2. 复制 Client ID 和 Client Secret

快速入门（Docker）

第一步：构建

docker compose build

步骤2：配置

cp .env.example .env
# Fill in GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET

步骤3：身份验证（一次）

docker compose run --rm -p 8082:8082 auth

第4步：向您的AI助手注册

Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google-docs": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "gdocs-suite-mcp-tokens:/tokens",
        "--env-file", "/absolute/path/to/.env",
        "gdocs-suite-mcp:latest",
        "serve"
      ]
    }
  }
}

Claude Code

claude mcp add --transport stdio google-docs -- \
  docker run --rm -i \
    -v gdocs-suite-mcp-tokens:/tokens \
    --env-file /absolute/path/to/.env \
    gdocs-suite-mcp:latest serve

Gemini CLI

添加 ~/.gemini/settings.json （或 .gemini/settings.json 项目级）：

{
  "mcpServers": {
    "gdocs-suite": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "gdocs-suite-mcp-tokens:/tokens",
        "--env-file", "/absolute/path/to/.env",
        "gdocs-suite-mcp:latest",
        "serve"
      ]
    }
  }
}

OpenAI Codex CLI

添加 ~/.codex/config.toml （或 .codex/config.toml 项目级）：

[mcp_servers.gdocs-suite]
command = "docker"
args = ["run", "--rm", "-i", "-v", "gdocs-suite-mcp-tokens:/tokens", "--env-file", "/absolute/path/to/.env", "gdocs-suite-mcp:latest", "serve"]
enabled = true

替代方案：本地安装

git clone https://github.com/stratosphereips/strato-mcp-gdocs-suite
cd strato-mcp-gdocs-suite
uv venv && source .venv/bin/activate
uv pip install -e .
cp .env.example .env

验证一次：

gdocs-suite-auth

启动MCP服务器：

gdocs-suite-mcp

可用工具

文件

电子表格

演示

表单

注： Forms工具需要两个额外的OAuth作用域(forms.body 和 forms.responses.readonly).如果您之前在没有这些作用域的情况下进行了身份验证，请重新运行身份验证步骤： docker compose run --rm -p 8082:8082 auth

配置参考

发展

uv pip install -e ".[dev]"
uv run pytest