AI导哈

Google幻灯片MCP服务器

一个用于Google幻灯片的MCP（模型上下文协议）服务器，使AI助手能够直接从聊天中创建、读取和编辑Google幻灯片演示文稿。

  • by ryanvo162
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ryanvo162/google-slides-mcp

使用说明

谷歌幻灯片MCP服务器

用于Google幻灯片的MCP（模型上下文协议）服务器。使AI助手（Claude Code、Cursor、Windsurf等）能够直接从聊天中创建、阅读和编辑Google幻灯片演示文稿。

特性

39工具 分为4类：

演示文稿（4）

工具 说明
createPresentation 创建新演示文稿
getPresentation 获取元数据和幻灯片摘要
listPresentations 在Drive上搜索演示文稿
duplicatePresentation 复制整个演示文稿（模板工作流）

幻灯片（10）

工具 说明
addSlide 添加一张带有布局的幻灯片（空白、标题、标题和边框等）
deleteSlide 删除幻灯片
duplicateSlide 复制幻灯片
reorderSlides 重新排序幻灯片
getSlide 获取幻灯片的详细元素信息
updateSlideBackground 设置背景颜色或图像
setSpeakerNotes / getSpeakerNotes 管理演讲者笔记
copySlideFromPresentation 从其他演示文稿导入幻灯片
setSkipSlide 在幻灯片放映中显示/隐藏幻灯片

元素（25）

组 工具
插入 insertTextBox、insertImage、insertShape、insertTable、insertVideo、insertLine
表格 insertTableRow、insertTableColumn、deleteTableRow、deleteTableColumn、updateTableCell、formatTableCell、mergeTableCells、unmergeTableCell
编辑 updateText，updateTextStyle，updateShapeStyle，setParagraphStyle，moveRezeElement
其他 deleteElement、groupElements、uncoupElements、replaceAllText、replaceImage、batchUpdate

出口（2）

工具 说明
exportPresentation 导出为PDF、PPTX或ODP
getThumbnail 获取幻灯片的缩略图

安装指南

第一步：创建谷歌云项目

  1. 首选 谷歌云控制台
  2. 点击 选择一个项目 > 新项目
  3. 命名您的项目（例如。， google-slides-mcp) > 创建

步骤2：启用API

  1. 导航至 API和服务 > 图书馆
  2. 搜索和 启用 这两个API：
    • 谷歌幻灯片API
    • Google Drive API

步骤3：创建OAuth凭据

  1. 首选 API和服务 > 凭证
  2. 点击 +创建凭据 > OAuth客户端ID
  3. 如果您尚未配置同意屏幕：
    • 点击 配置同意屏幕
    • 选择 外部 > 创建
    • 填写 应用程序名称 （例如。， Slides MCP)
    • 添加 用户支持电子邮件 和 开发人员联系电子邮件
    • 点击 保存并继续 通过所有步骤> 返回仪表盘
  4. 回去 凭证 > +创建凭据 > OAuth客户端ID
  5. 应用程序类型： 桌面应用
  6. 命名它（例如。， Slides MCP Desktop)
  7. 点击 创建
  8. 点击 下载JSON >另存为 credentials.json

步骤4：安装

git clone https://github.com/ryanvo162/google-slides-mcp.git
cd google-slides-mcp
npm install
npm run build

步骤5：授权

复制您的 credentials.json （在步骤3中下载）放入项目文件夹：

cp /path/to/credentials.json .

运行身份验证流：

node dist/index.js auth

终端中会出现一个URL。在浏览器中打开它，使用您的Google帐户登录，然后授予访问权限。您的令牌将保存在 ~/.config/google-slides-mcp/token.json.

注： 如果您看到“此应用程序未验证”，请单击 高级 > 转到幻灯片MCP（不安全）。这对于未经验证的应用程序来说是正常的。

步骤6：使用Claude代码进行配置

打开 ~/.claude.json 并添加到 mcpServers 章节：

{
  "mcpServers": {
    "google-slides": {
      "command": "node",
      "args": ["/full/path/to/google-slides-mcp/dist/index.js"]
    }
  }
}

替换 /full/path/to/ 使用机器上的实际路径。

macOS示例：

"args": ["/Users/username/google-slides-mcp/dist/index.js"]

Windows示例：

"args": ["C:\\Users\\username\\google-slides-mcp\\dist\\index.js"]

然后 重新启动克劳德代码 加载MCP服务器。

步骤7：测试

打开克劳德代码并尝试：

Create a new presentation called "Hello World"

如果克劳德创建了演示文稿并返回了谷歌幻灯片链接，那么一切就都准备好了！

其他MCP客户端

光标/风帆

添加 .cursor/mcp.json 或 .windsurf/mcp.json:

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

克劳德桌面

添加 claude_desktop_config.json:

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-slides": {
      "command": "node",
      "args": ["/path/to/google-slides-mcp/dist/index.js"]
    }
  }
}

环境变量（可选）

变量 描述
GOOGLE_CLIENT_ID OAuth客户端ID（替代credentials.json）
GOOGLE_CLIENT_SECRET OAuth客户端密钥
SERVICE_ACCOUNT_PATH 服务帐户密钥文件的路径
GOOGLE_IMPERSONATE_USER 要冒充的电子邮件（仅限服务帐户）
GOOGLE_MCP_PROFILE 个人资料名称（支持多个Google帐户）
LOG_LEVEL debug、info、warn、error、silent（默认：info）

安全

  • OAuth state CSRF保护参数
  • 有权限存储的令牌文件 0600 （仅限所有者阅读）
  • 客户端机密未持久化在令牌文件中
  • 配置文件名称净化（防止路径遍历）
  • 最低OAuth作用域： presentations + drive.file

技术栈

故障排除

“未找到OAuth凭据”

复制 credentials.json 进入项目根。请参阅步骤3和5。

“令牌可能过期”

跑 node dist/index.js auth 再次重新授权。

“Google幻灯片客户端未初始化”

检查 credentials.json 有效，并且Google Slides API已启用（步骤2）。

Claude Code未显示工具

验证中的路径 ~/.claude.json 是正确的。更新配置后重新启动Claude Code。

许可证

国际学生委员会

相关 MCP