Gamma

@mindstone/mcp-server-gamma

用于创建 Gamma 演示文稿、文档、网页和社交帖子，列出主题和文件夹，并轮询异步生成/导出状态的 Gamma MCP 服务。

最适合希望通过本地软件包，使用自己管理的 API 密钥创建 Gamma 演示文稿和导出文件的 MCP 宿主。

状态

• 版本： 0.4.1 · npm
• 身份验证： API 密钥 (GAMMA_API_KEY)
• 工具： 6（主题、文件夹、生成）
• 接口类型： cloud-api
• 机器可读： STATUS.json

为什么要开发此项目

Gamma 托管的 MCP 服务是无代码和远程连接器工作流最简单的选择。此软件包面向已经管理 npm 软件包和 API 密钥的本地 MCP 宿主。

它为助手提供了实用的 Gamma 创建流程：选择主题或文件夹，开始生成演示文稿/文档/网页，等待完成，然后返回 Gamma 链接或导出的 PDF/PPTX。它的优势很简单：无需离开宿主，就能将提示词转化为可用的 Gamma 资源。

交互示例

“使用我们的企业主题创建一份关于第四季度业绩的 10 页投资者简报，并导出为 PPTX。”

宿主调用的工具：

1. gamma_list_themes — 查找自定义主题 ID。
2. gamma_generate — 使用 export_as: "pptx" 开始生成演示文稿。
3. gamma_get_status — 轮询，直到 Gamma 完成演示文稿和导出。

响应（节选）：

{
  "generation_id": "gen_123",
  "status": "completed",
  "gamma_url": "<untrusted-content source=\"gamma:generation.url\">https://gamma.app/docs/...</untrusted-content>",
  "pptx_url": "<untrusted-content source=\"gamma:generation.url\">https://...</untrusted-content>",
  "file_path": "/tmp/gamma_export_gen_123_abcd.pptx"
}

外部字符串（主题/文件夹名称、主题关键词、状态错误文本和 URL）会放在 <untrusted-content> 包装中返回，使模型将其视为数据而非指令。

要求

• Node.js 20+
• npm

一键安装

点击按钮后，宿主会提示你填写：GAMMA_API_KEY、GAMMA_EXPORT_POLL_INTERVAL_MS、GAMMA_EXPORT_POLL_MAX_ATTEMPTS、GAMMA_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Gamma": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-gamma"
      ],
      "env": {
        "GAMMA_API_KEY": "",
        "GAMMA_EXPORT_POLL_INTERVAL_MS": "5000",
        "GAMMA_EXPORT_POLL_MAX_ATTEMPTS": "12",
        "GAMMA_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

快速开始

安装与构建

cd <path-to-repo>/connectors/gamma
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-gamma

本地

node dist/index.js

配置

环境变量

• GAMMA_API_KEY — Gamma API 密钥
• GAMMA_EXPORT_POLL_INTERVAL_MS — 导出轮询间隔，单位为毫秒（默认值：5000）
• GAMMA_EXPORT_POLL_MAX_ATTEMPTS — 导出轮询的最大尝试次数（默认值：12）
• GAMMA_REQUEST_TIMEOUT_MS — 可选覆盖值（正整数，单位为毫秒，最长 30 分钟），用于设置应用于 Gamma API 和主机桥接调用的出站 HTTP 请求超时时间。默认值：60000（60 秒）。如果缓慢提交时出现 TIMEOUT 错误，可调高此值；如果想要更严格地限制等待时间，可调低此值。
• MCP_HOST_BRIDGE_STATE — 主机提供桥接状态文件时，用于凭据管理的主机管理型桥接状态文件；普通手动设置无需此项。
• MINDSTONE_REBEL_BRIDGE_STATE — 与 MCP_HOST_BRIDGE_STATE 向后兼容的别名。

主机配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Gamma": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-gamma"],
      "env": {
        "GAMMA_API_KEY": "your-api-key"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "Gamma": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/gamma/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "your-api-key"
      }
    }
  }
}

工具（6 个）

配置

• configure_gamma_api_key — 配置 Gamma API 密钥

列表

• gamma_list_themes — 列出可用的 Gamma 主题（自定义和标准主题）
• gamma_list_folders — 列出用户 Gamma 工作区中的文件夹

生成

• gamma_generate — 创建 AI 驱动的演示文稿、文档、网页或社交媒体帖子
• gamma_create_from_template — 使用 AI 克隆并修改现有 Gamma 文档
• gamma_get_status — 轮询 Gamma 生成任务的状态

安全说明

• Gamma API 调用使用 GAMMA_API_KEY 作为 x-api-key 请求头。
• configure_gamma_api_key 可以将密钥存储在内存中，或者在存在 MCP_HOST_BRIDGE_STATE 时将其交给主机桥接。
• 配置后，主机桥接请求会发送到 127.0.0.1，并使用桥接状态文件中的令牌。
• gamma_list_themes / gamma_list_folders 返回的主题和文件夹名称以及主题关键词数组是由工作区编写的文本，会包装在 <untrusted-content> 信封中，以便模型将其视为数据而非指令。通过失败关闭的 Zod 验证会剥离未知的供应商添加的响应字段，且供应商错误正文绝不会写入日志或模型可见的错误信息中。
• PDF/PPTX 导出文件会从 Gamma 提供的 URL 下载到系统临时目录。任何出站请求之前都会验证导出 URL：仅允许 HTTPS，不允许用户信息，拒绝私有、环回和保留主机，并将主机限制为 gamma.app 及其子域名。手动跟随重定向，并对每一跳重新执行相同的验证；下载文件以原子方式写入（在不可预测的路径上以独占、禁止跟随符号链接的方式创建，模式为 0600）。
• 生成操作可能会在用户的 Gamma 工作区中创建内容、消耗 Gamma 点数，并设置工作区或外部共享选项；因此，生成工具会相应地标注 destructiveHint: true。

许可证

FSL-1.1-MIT — 功能源代码许可证，版本 1.1，未来采用 MIT 许可证。该软件将于 2030-04-08 转为 MIT 许可证。