Google Slides MCP

Google Slides MCP

English | Русский

A1 Google Slides MCP 让 AI 应用能够通过自然语言创建和编辑 Google Slides 演示文稿。起草幻灯片、添加和调整幻灯片顺序、编写和设置文本样式、放置形状、图片和表格、保留演讲者备注和评论，并将结果导出为 PDF 或 PPTX。

它使用 Google Slides API 和您的 Google 账号。幻灯片中的所有内容都通过明确的对象 ID 寻址，并明确说明 Slides API 的限制，而不会暗示所有演示文稿任务都能实现。

• 32 个工具。 检查演示文稿和页面，编辑幻灯片、文本、形状、图片和表格，管理演讲者备注和评论，渲染缩略图并导出文件。
• 通过对话连接。 说“连接 Google Slides”：服务会引导您配置 OAuth 客户端，通过 PKCE 在 127.0.0.1 捕获 Google 的重定向，并自行保留令牌——无需配置文件，也无需重启。
• 编辑以原子方式执行。 更改通过 API 的 batchUpdate 提交：一条无效请求就会使整个批次失效，因此演示文稿不会处于只编辑了一部分的状态。
• 不会访问您的云端硬盘。 评论、导出和本地图片上传仅使用 Drive API 处理单个演示文稿文件——没有用于列出、共享、重命名或删除 Drive 文件的工具。
• 最小化 Google 权限范围。 需要 presentations；只有处理本地图片、评论和导出时才需要 Drive 权限范围。

从只读问题开始：

显示季度报告演示文稿中的幻灯片，以及每张幻灯片的内容。

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解它的工作方式

您： 列出 Q3 评审演示文稿中的幻灯片，以及每张幻灯片的内容。

助手： 显示简洁清单：每张幻灯片的位置、版式和包含可见文本的元素。不会修改任何内容。

您： 在议程后新增一张标题为“路线图”的幻灯片，正文中写入关键日期。

助手： 显示目标演示文稿、版式和拟定文本，然后在添加前请求确认。

您： 确认。

助手： 添加幻灯片并填入占位符。不会改动其他幻灯片。

目录

• 快速开始
• 您可以让它做什么
• 演示文稿如何更改
• 可以更改的内容
• 获取访问权限
• 配置
• 数据、限制和后台工作
• 技术文档
• 支持

快速开始

你需要 Node.js 20+ 和一个 Google 账号。安装时不需要凭据——服务会在对话过程中连接。

1. 将服务添加到你的 AI 应用。
2. 说“连接 Google Slides”：助手会引导你创建 OAuth 客户端并批准访问，无需编辑配置文件。
3. 提出上面的只读问题。

codex mcp add google-slides \
  -- npx -y @a1-x-tech/mcp-google-slides@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-slides \
  -- npx -y @a1-x-tech/mcp-google-slides@latest

claude mcp list

{
  "mcpServers": {
    "google-slides": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-slides": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

{
  "servers": {
    "google-slides": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

你可以让它做什么

检查演示文稿

• 列出此演示文稿中的幻灯片及每张幻灯片的内容。
• 读取第 5 张幻灯片的演讲者备注。
• 渲染标题幻灯片的缩略图。

创建和重新排列幻灯片

• 创建一份用于 Q3 评审的演示文稿。
• 在议程后添加一张“路线图”幻灯片，复制模板幻灯片，将摘要移到末尾。
• 从 URL 或本地文件插入图片，添加一个 4×3 表格，创建文本框或带标题的圆角矩形。

编写和润色文本

• 将这段文本放入标题占位符，并将截止日期设为粗体红色。
• 将整份演示文稿中的“Q2”替换为“Q3”。
• 将第 3 张幻灯片的演讲者备注改写得更简短。

审阅和交接

• 列出未解决的评论讨论，并回复第一条评论后将其解决。
• 删除不再需要的草稿幻灯片。
• 将演示文稿导出为 PDF 或 PPTX，供无法访问 Google 的人查看。

演示文稿如何变化

1. create_presentation 会创建一个仅含标题幻灯片的演示文稿；创建时只有标题会生效。
2. 演示文稿中的所有内容——幻灯片、形状、图片、表格——都通过对象 ID寻址。在进行任何编辑前，先从 list_slides 获取精简清单。
3. 编辑通过 API 的原子 batchUpdate 执行：一个无效请求就会使整个批次失效，因此不会出现只应用了一部分的情况。
4. 工具输入的单位是点；API 存储的单位是 EMU（1 pt = 12700 EMU）。服务会进行双向转换。

Slides API 无法删除、重命名或共享演示文稿文件——这些属于 Drive 文件操作，不在此服务的范围内。它无法导入主题（只能实例化演示文稿中已有的版式），也无法将新评论锚定到特定幻灯片。导出大小上限为 10 MB，缩略图 URL 大约 30 分钟后过期。

可以更改的内容

AI 客户端负责控制确认提示。服务会标记读取、写入和破坏性工具，以便客户端区分检查操作与实际更改。

获取访问权限

Google Slides 需要 OAuth 2.0；仅有 API 密钥并不足够。有两种接入方式，第一种无需配置文件。

从聊天中连接（推荐）

说“连接 Google Slides”，助手就会引导你完成流程：

1. setup_instructions 会打印检查清单：创建或选择 Google Cloud 项目、启用 Google Slides API、配置同意屏幕并创建 桌面应用 OAuth 客户端。
2. 下载该客户端的 JSON（“Download JSON”），并将其路径提供给助手——set_client 会以仅所有者可访问的权限保存该文件。密钥绝不会经过对话传递。
3. start_login 会返回 Google 授权链接。在这台机器上打开链接并批准；授权码会返回到 127.0.0.1 上的一次性监听器（PKCE），不会经过聊天传递。
4. finish_login 会交换授权码，并将令牌保存到 ~/.config/mcp-google-slides/credentials.json（模式 0600）。

每次调用时都会重新读取令牌，因此连接会立即生效——无需重启 AI 应用。auth_status 会显示当前连接状态，logout 会撤销并删除连接。

环境变量（CI、无人值守安装）

1. 创建或选择一个 Google Cloud 项目并启用 Google Slides API。如果需要评论、导出或上传本地图片，也请启用 Google Drive API。

2. 配置 OAuth 同意屏幕并创建 Desktop app OAuth 客户端。

3. 授权拥有演示文稿或可以编辑演示文稿的 Google 账号。启用 Use your own OAuth credentials 后，可以使用 OAuth 2.0 Playground 获取刷新令牌。

4. 请求以下范围：

   https://www.googleapis.com/auth/presentations
   https://www.googleapis.com/auth/drive.file
   

   presentations 涵盖所有 Slides 读取和写入操作。drive.file 涵盖本地图片上传，以及对此应用创建的演示文稿进行评论和导出；需要对任意演示文稿进行评论或导出时，请改为请求更广泛的 https://www.googleapis.com/auth/drive。

测试模式下的 OAuth 刷新令牌可能会在七天后过期。需要长期访问时，请发布 OAuth 应用，或在 Workspace 网域中使用 Internal 应用。请将客户端密钥和刷新令牌视为密码。

配置

所有变量均为可选项——不设置任何变量时，服务会从聊天中连接。

* 请提供 OAuth 三项配置或访问令牌。

数据、限制和后台工作

• 请求会发送到 Google Slides。 本地服务会刷新 Google OAuth 令牌并调用 Slides API；评论、导出和本地图片上传通过 Drive API 执行，范围仅限于单个演示文稿文件。匿名遥测包含安装 ID、软件包版本、AI 客户端和平台版本，以及工具名称——绝不包含 OAuth 令牌、演示文稿内容、工具参数或提示词。设置 ASKADS_TELEMETRY=0 即可选择退出。
• Google 会实施速率限制。 遇到 429 时，服务会采用退避策略；读取操作在网络错误和 5xx 错误后也会重试，而写入操作在发生不确定故障后不会重放。缩略图会占用更多读取配额。
• 没有后台轮询。 服务只会在被调用时运行。调用之间不会监视演示文稿；如果你的 AI 应用支持计划任务，可以定期检查演示文稿。

技术文档

• MCP 功能目录 — 面向任务的页面，介绍每个工具。
• 所有工具和输入
• 开发文档
• 发布文档
• Google Slides API 参考

支持

发现了错误或需要支持某种使用场景？创建问题或在 Telegram 上留言。

你已读到最后！