谷歌幻灯片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 | 获取幻灯片的缩略图 |
______________________________________________________________________
安装指南
第一步：创建谷歌云项目
- 首选 谷歌云控制台
- 点击 选择一个项目 > 新项目
- 命名您的项目（例如。，
google-slides-mcp) > 创建
步骤2：启用API
- 导航至 API和服务 > 图书馆
- 搜索和 启用 这两个API：
- 谷歌幻灯片API - Google Drive API
步骤3：创建OAuth凭据
- 首选 API和服务 > 凭证
- 点击 +创建凭据 > OAuth客户端ID
- 如果您尚未配置同意屏幕：
- 点击 配置同意屏幕 - 选择 外部 > 创建 - 填写 应用程序名称 （例如。， Slides MCP) - 添加 用户支持电子邮件 和 开发人员联系电子邮件 - 点击 保存并继续 通过所有步骤> 返回仪表盘
- 回去 凭证 > +创建凭据 > OAuth客户端ID
- 应用程序类型： 桌面应用
- 命名它（例如。，
Slides MCP Desktop) - 点击 创建
- 点击 下载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
stateCSRF保护参数 - 有权限存储的令牌文件
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。
许可证
国际学生委员会