Google Slides MCP Server

Google Slides MCP 服务

此进程是 Google Slides API 的 MCP 服务。宿主通过标准输入输出与其通信。首次启动时会打开浏览器。粘贴 Desktop 客户端 ID 和客户端密钥，然后完成 Google 授权。之后启动时会读取令牌存储。

前提条件

• Node.js 20 或更高版本
• 已启用 Google Slides API 的 Google Cloud 项目
• OAuth Desktop 客户端 ID 和客户端密钥

无需刷新令牌，也无需进程环境变量。

Claude Code

1. 创建 Desktop OAuth 客户端。请按照下方的 Google Auth 平台步骤操作。
2. 在 Claude Code 中运行：

/plugin marketplace add matteoantoci/claude-plugins
/plugin install google-slides-mcp@matteoantoci-plugins

3. 如果 Claude 提示，请运行 /reload-plugins。
4. 首次启动时会打开浏览器。粘贴客户端 ID 和客户端密钥，然后完成 Google 授权。

之后的会话会读取令牌存储。无需宿主 JSON，也无需环境变量。

其他宿主

1. 克隆此仓库。
2. 运行 npm install。
3. 运行 npm run build。
4. 在 Google Cloud Console 中创建 Desktop OAuth 客户端：
   • 打开 Google Auth platform。
   • 如果页面显示平台尚未配置，请点击 Get Started。
   • 应用名称：Google Slides MCP。用户支持邮箱：你的邮箱地址。
   • 受众群体：External。
   • 联系邮箱：你的邮箱地址。接受相关政策，然后点击 Create。
   • 打开 Audience。将你的 Gmail 地址添加为测试用户。
   • 打开 Data Access。添加 https://www.googleapis.com/auth/presentations 和 https://www.googleapis.com/auth/drive.readonly。保存。
   • 打开 Clients。点击 Create Client。应用类型：Desktop app。名称：Google Slides MCP Desktop。点击 Create。
   • 复制客户端 ID 和客户端密钥。
5. 运行 npm run start。粘贴客户端 ID 和客户端密钥，然后完成 Google 授权。随后停止进程。
6. 将宿主指向 node /path/to/google-slides-mcp/build/index.js。不要设置环境变量。

宿主配置示例：

"google-slides-mcp": {
  "transportType": "stdio",
  "command": "node",
  "args": [
    "/path/to/google-slides-mcp/build/index.js"
  ]
}

将路径替换为你计算机上编译后的 build/index.js 路径。

首次启动

进程会打开一个环回页面。

• 如果存储中没有客户端 ID 或客户端密钥，请粘贴这两个值。
• 继续完成 Google 授权。
• 关闭成功页面。

进程会将 Google 凭据写入令牌存储。它会优先尝试使用操作系统钥匙串。如果钥匙串不可用，则会使用 ~/.config/google-slides-mcp/credential.json。文件权限模式为 0600。

之后启动时会使用存储中的凭据，无需打开浏览器。

GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET 和 GOOGLE_REFRESH_TOKEN 可用于覆盖单个字段，但都不是必需的。如果环境变量提供了缺失字段，进程会将合并后的凭据写入存储。

不通过宿主运行

npm run start

进程会监听标准输入输出。标准错误会打印 Google Slides MCP server running and connected via stdio.。

可用工具

• create_presentation：创建新的 Google Slides 演示文稿。

  • 输入：
    • title（字符串，必填）：新演示文稿的标题。
  • **输出：**表示所创建演示文稿详情的 JSON 对象。

• get_presentation：检索现有演示文稿的详情。

  • 输入：
    • presentationId（字符串，必填）：要检索的演示文稿 ID。
    • fields（字符串，可选）：字段掩码（例如 "slides,pageSize"），用于限制返回的数据。
  • **输出：**表示演示文稿详情的 JSON 对象。

• batch_update_presentation：对演示文稿应用一系列更新。这是修改幻灯片的主要方法（添加文本、形状、图片、创建幻灯片等）。

  • 输入：
    • presentationId（字符串，必填）：要更新的演示文稿 ID。
    • requests（数组，必填）：定义更新内容的请求对象数组。有关各个请求的结构，请参阅 Google Slides API batchUpdate 文档。
    • writeControl（对象，可选）：控制写入请求的执行（例如，使用修订 ID）。
  • **输出：**表示批量更新结果的 JSON 对象。

• get_page：检索演示文稿中特定页面（幻灯片）的详情。

  • 输入：
    • presentationId（字符串，必填）：要检索的演示文稿 ID。
    • pageObjectId（字符串，必填）：要检索的页面（幻灯片）对象 ID。
  • **输出：**表示页面详情的 JSON 对象。

• summarize_presentation：提取并整理演示文稿中的所有文本内容，以便更轻松地进行摘要。

  • 输入：
    • presentationId（字符串，必填）：要生成摘要的演示文稿 ID。
    • include_notes（布尔值，可选）：是否在摘要中包含演讲者备注。默认为 false。
  • **输出：**包含以下内容的 JSON 对象：
    • title：演示文稿的标题
    • slideCount：幻灯片总数
    • lastModified：修订信息
    • slides：幻灯片对象数组，包含：
      • slideNumber：在演示文稿中的位置
      • slideId：幻灯片的对象 ID
      • content：从幻灯片中提取的所有文本
      • notes：演讲者备注（如果已请求且可用）