gamma-mcp-server

Gamma MCP 服务

一个 Model Context Protocol（MCP）服务，可将 Gamma.app 集成到 AI 助手中。直接通过 AI 对话创建演示文稿、文档、网页和社交媒体帖子。

兼容：Claude Code、Claude Desktop、OpenCode、GitHub Copilot CLI、Google Gemini CLI，以及任何其他兼容 MCP 的 AI 助手。

功能

• 生成内容：根据文本提示词创建专业的演示文稿、文档、网页和社交媒体帖子
• 主题支持：浏览并为内容应用视觉主题
• 文件夹整理：将生成的内容保存到指定文件夹
• 模板改编：基于现有 Gamma 模板创建变体
• 邮件分享：通过邮件直接分享生成的内容

快速开始

1. 克隆并安装

git clone https://github.com/Arkava-AI/gamma-mcp-server.git
cd gamma-mcp-server
npm install
npm run build

2. 获取 Gamma API 密钥

1. 登录 gamma.app
2. 前往 Settings > API（或 Settings > Members > API 选项卡）
3. 点击 Create API key
4. 复制密钥（格式：sk-gamma-xxxxxxxx）

注意：需要 Gamma Pro、Ultra、Team 或 Business 账户。

3. 配置 AI 助手

从下方选择你的 AI 助手，查看配置说明。

---

Claude Desktop（macOS / Windows / Linux）

配置文件

OS	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

将以下内容添加到 mcpServers 对象中：

{
  "mcpServers": {
    "gamma": {
      "command": "node",
      "args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      }
    }
  }
}

重启 Claude Desktop

重启 Claude Desktop 以加载新的 MCP 服务。你应该会在 MCP 服务列表中看到“gamma”。

---

Claude Code

Claude Code 使用与 Claude Desktop 相同的 MCP 配置。如果你已经配置了 Claude Desktop，就无需再做其他设置。

如需进行项目级配置，请在项目目录中创建 .claude/settings.json 文件，并使用上文所示的相同 mcpServers 结构。这样，不同项目就可以使用不同的 MCP 服务配置。

---

OpenCode

配置文件

范围	路径
全局（用户）	~/.config/opencode/opencode.json
项目	./opencode.json（位于项目根目录）

JSON 结构

{
  "mcp": {
    "gamma": {
      "type": "local",
      "command": ["node", "/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "enabled": true,
      "environment": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      }
    }
  }
}

注意：OpenCode 使用的配置格式与 Claude Desktop 不同：使用 mcp（而不是 mcpServers），必须包含 type 字段（"local" 或 "remote"），command 是一个数组，环境变量放在 environment 下。

编辑配置后重启 OpenCode，以加载该服务。

---

GitHub Copilot CLI

配置文件

• ~/.copilot/mcp-config.json

JSON 结构

{
  "mcpServers": {
    "gamma": {
      "type": "local",
      "command": "node",
      "args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      },
      "tools": ["*"]
    }
  }
}

注意：需要 GitHub Copilot CLI（gh copilot），与 OpenAI Codex 不同。

---

OpenAI Codex

配置文件

• ~/.codex/config.toml（TOML 格式，非 JSON）

TOML 结构

[mcp_servers.gamma]
command = "node"
args = ["/absolute/path/to/gamma-mcp-server/dist/index.js"]
enabled = true

[mcp_servers.gamma.env]
GAMMA_API_KEY = "sk-gamma-your-api-key-here"

注意：Codex 使用 TOML 格式，而非 JSON。env 部分是 [mcp_servers.gamma.env] 下的独立表。

---

Google Gemini CLI

配置文件

范围	路径
用户	~/.gemini/settings.json
项目	.gemini/settings.json（位于项目根目录）

JSON 结构

{
  "mcpServers": {
    "gamma": {
      "command": "node",
      "args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "cwd": "/absolute/path/to/gamma-mcp-server",
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      },
      "timeout": 30000
    }
  }
}

编辑配置后，重启 Gemini CLI 以加载该服务。

---

可用工具

工具	描述
gamma_generate	创建演示文稿、文档、网页或社交媒体帖子
gamma_get_status	检查生成进度（可选轮询）
gamma_from_template	混编现有的 Gamma 模板
gamma_list_themes	浏览可用的视觉主题
gamma_list_folders	列出你的 Gamma 文件夹
gamma_share_email	通过电子邮件分享内容
gamma_health	验证服务和 API 是否可访问
gamma_archive	将 Gamma 归档到你的工作区

gamma_generate

使用 Gamma 的 AI 创建新内容。

格式与尺寸：

• presentation：fluid、16x9、4x3
• document：fluid、pageless、letter、a4
• social：1x1、4x5、9x16
• webpage：fluid

AI 助手提示词示例：

• “创建一份关于可持续能源的 5 页演示文稿”
• “生成一份说明我们第一季度业绩的文档”
• “制作一条宣布我们新产品的社交媒体帖子”

gamma_get_status

检查生成是否已完成。将 waitForCompletion: true 设为自动轮询，直到完成。

gamma_from_template

使用新内容或变量替换来混编现有的 Gamma。

{
  "templateId": "gamma_xyz789",
  "prompt": "Update for Q1 2025",
  "variables": { "company_name": "Acme Corp" }
}

---

多机器设置

此仓库旨在便于在多台机器上部署：

# On each machine:
git clone https://github.com/Arkava-AI/gamma-mcp-server.git
cd gamma-mcp-server
npm install && npm run build

# Then configure your AI assistant with the local path

在任意机器上更新：

git pull
npm install
npm run build
# Restart your AI assistant

---

环境变量

变量	默认值	描述
GAMMA_API_KEY	（必需）	你的 Gamma API 密钥（sk-gamma-...）
GAMMA_API_BASE_URL	https://public-api.gamma.app/v1.0	用于覆盖可自托管的 Gamma 实例
GAMMA_POLL_INTERVAL_MS	2000	状态轮询间隔（毫秒，默认 2 秒）
GAMMA_MAX_POLL_ATTEMPTS	150	超时前的最大轮询次数（默认 150 × 2 秒 = 5 分钟）

---

开发

# Run in development mode with auto-reload
npm run dev

# Build for production
npm run build

# Run linting
npm run lint

# Format code
npm run format

# Type check
npm run typecheck

# Test with MCP Inspector
npm run inspect

---

项目结构

gamma-mcp-server/
├── src/
│   ├── index.ts          # Main entry point
│   ├── constants.ts      # Configuration constants
│   ├── types.ts          # TypeScript interfaces
│   ├── schemas/          # Zod validation schemas
│   ├── services/         # API client and formatters
│   └── tools/            # MCP tool implementations
├── dist/                 # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── eslint.config.js

---

API 积分

Gamma 使用基于积分的 API 用量系统。每次生成都会消耗积分。请在 Gamma 控制面板中监控用量，并在需要时启用自动充值。

---

故障排除

错误	解决方案
"GAMMA_API_KEY environment variable is required"	确保在 AI 助手的 MCP 配置中设置了 env.GAMMA_API_KEY
"Invalid API key"	密钥应以 sk-gamma- 开头。请验证完整密钥。
"Rate limit exceeded"	等待几分钟。如需提高限制，请联系 Gamma 支持。
"Insufficient credits"	充值积分，或在 Gamma 设置中启用自动充值。

---

要求

• Node.js 18+
• Gamma Pro/Ultra/Team/Business 账户（用于 API 访问）
• 兼容 MCP 的 AI 助手（Claude Code、Claude Desktop、OpenCode、GitHub Copilot CLI、Gemini CLI 等）

---

维护者

Arkava Ltd — [email protected]

---

许可证

MIT 许可证 - 详情请参阅 LICENSE。

---

链接

• Gamma 开发者文档
• MCP 规范
• Gamma.app