Gamma Mcp Server

io.github.amer-prog由 GitHub 账号 amer-prog 发布v1.0.0更新于 Nov 3, 2026

Create presentations, documents, and webpages from any MCP-compatible AI assistant via Gamma.app

已验证STDIO仅桌面效率与工作流媒体与设计

概览

AI 生成的概览

将 AI 助手连接到 Gamma.app,可生成演示文稿、文档、网页和社交媒体帖子,并管理生成结果。

可以做什么
  • 根据提示词生成演示文稿、文档、网页和社交媒体帖子,可选格式与尺寸
  • 查询生成进度(可自动轮询至完成),并检查服务器与 API 是否可达
  • 基于现有 Gamma 模板进行改写,替换内容或变量
  • 浏览可用的视觉主题,列出你的 Gamma 文件夹
  • 通过电子邮件分享生成内容,并将工作区中的项目归档
适用场景
适合希望助手在对话中直接起草 Gamma 幻灯片、文档、网页或社交媒体帖子,或改写现有 Gamma 模板并分享成果的场景。
运行要求
以本地 Node.js 18+ 进程运行,需从 npm 包或代码仓库构建。需要 Gamma API 密钥,通过环境变量 GAMMA_API_KEY 提供,并要求 Gamma Pro、Ultra、Team 或 Business 账户。可选变量可覆盖 API 基础地址、轮询间隔与轮询次数上限。
安装前请注意
Gamma API 密钥是机密信息,需写入助手的 MCP 配置文件,请妥善保管该文件。每次生成都会消耗 Gamma API 额度,会产生费用且额度可能用尽。该服务器会创建内容、发送邮件分享并归档工作区项目,属于写入操作。提示词与内容会发送至 Gamma 的 API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gamma Mcp Server,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Gamma MCP Server

[License: MIT] [Node.js Version] [TypeScript] [npm version] [npm downloads] [CI] [MCP SDK]

A Model Context Protocol (MCP) server that integrates Gamma.app with AI assistants. Create presentations, documents, webpages, and social posts directly from your AI conversations.

Works with: Claude Code, Claude Desktop, OpenCode, GitHub Copilot CLI, Google Gemini CLI, and any other MCP-compatible AI assistant.

Features

  • Generate Content: Create professional presentations, documents, webpages, and social posts from text prompts
  • Theme Support: Browse and apply visual themes to your content
  • Folder Organization: Save generated content to specific folders
  • Template Remix: Create variations of existing Gamma templates
  • Email Sharing: Share generated content directly via email

Quick Start

1. Clone and Install

bash
git clone https://github.com/Arkava-AI/gamma-mcp-server.gitcd gamma-mcp-servernpm installnpm run build

2. Get Your Gamma API Key

  1. Log in to gamma.app
  2. Go to Settings > API (or Settings > Members > API tab)
  3. Click Create API key
  4. Copy the key (format: sk-gamma-xxxxxxxx)

Note: Requires Gamma Pro, Ultra, Team, or Business account.

3. Configure Your AI Assistant

Choose your AI assistant below for setup instructions.


Claude Desktop (macOS / Windows / Linux)

Config File

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

Add to the mcpServers object:

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

Restart Claude Desktop

Restart Claude Desktop to load the new MCP server. You should see "gamma" in your MCP servers list.


Claude Code

Claude Code uses the same MCP configuration as Claude Desktop. If you've already configured Claude Desktop, you're all set.

For project-level configuration, create a .claude/settings.json file in your project directory with the same mcpServers structure shown above. This allows different projects to use different MCP server configurations.


OpenCode

Config File

ScopePath
Global (user)~/.config/opencode/opencode.json
Project./opencode.json (in your project root)

JSON Structure

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"      }    }  }}

Note: OpenCode uses a different config format from Claude Desktop — mcp (not mcpServers), type field required ("local" or "remote"), command is an array, and env vars go under environment.

Restart OpenCode after editing the config to load the server.


GitHub Copilot CLI

Config File

  • ~/.copilot/mcp-config.json

JSON Structure

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": ["*"]    }  }}

Note: Requires the GitHub Copilot CLI (gh copilot) — not the same as OpenAI Codex.


OpenAI Codex

Config File

  • ~/.codex/config.toml (TOML format, not JSON)

TOML Structure

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"

Note: Codex uses TOML format, not JSON. The env section is a separate table under [mcp_servers.gamma.env].


Google Gemini CLI

Config File

ScopePath
User~/.gemini/settings.json
Project.gemini/settings.json (in your project root)

JSON Structure

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    }  }}

Restart Gemini CLI after editing the config to load the server.


Available Tools

ToolDescription
gamma_generateCreate presentations, documents, webpages, or social posts
gamma_get_statusCheck generation progress (with optional polling)
gamma_from_templateRemix existing Gamma templates
gamma_list_themesBrowse available visual themes
gamma_list_foldersList your Gamma folders
gamma_share_emailShare content via email
gamma_healthVerify server and API are reachable
gamma_archiveArchive a Gamma from your workspace

gamma_generate

Create new content using Gamma's AI.

Formats & Sizes:

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

Example prompts in your AI assistant:

  • "Create a 5-slide presentation about sustainable energy"
  • "Generate a document explaining our Q1 results"
  • "Make a social media post announcing our new product"

gamma_get_status

Check if a generation has completed. Set waitForCompletion: true to automatically poll until done.

gamma_from_template

Remix an existing Gamma with new content or variable substitutions.

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

Multi-Machine Setup

This repository is designed for easy deployment across multiple machines:

bash
# On each machine:git clone https://github.com/Arkava-AI/gamma-mcp-server.gitcd gamma-mcp-servernpm install && npm run build
# Then configure your AI assistant with the local path

To update on any machine:

bash
git pullnpm installnpm run build# Restart your AI assistant

Environment Variables

VariableDefaultDescription
GAMMA_API_KEY(required)Your Gamma API key (sk-gamma-...)
GAMMA_API_BASE_URLhttps://public-api.gamma.app/v1.0Override for self-hosted Gamma instances
GAMMA_POLL_INTERVAL_MS2000Milliseconds between status polls (default 2s)
GAMMA_MAX_POLL_ATTEMPTS150Max polling attempts before timeout (default 150 × 2s = 5 min)

Development

bash
# Run in development mode with auto-reloadnpm run dev
# Build for productionnpm run build
# Run lintingnpm run lint
# Format codenpm run format
# Type checknpm run typecheck
# Test with MCP Inspectornpm run inspect

Project Structure

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 Credits

Gamma uses a credit-based system for API usage. Credits are consumed per generation. Monitor your usage in the Gamma dashboard and enable auto-recharge if needed.


Troubleshooting

ErrorSolution
"GAMMA_API_KEY environment variable is required"Ensure env.GAMMA_API_KEY is set in your AI assistant's MCP config
"Invalid API key"Keys should start with sk-gamma-. Verify the complete key.
"Rate limit exceeded"Wait a few minutes. Contact Gamma support for higher limits.
"Insufficient credits"Top up credits or enable auto-recharge in Gamma settings.

Requirements

  • Node.js 18+
  • Gamma Pro/Ultra/Team/Business account (for API access)
  • MCP-compatible AI assistant (Claude Code, Claude Desktop, OpenCode, GitHub Copilot CLI, Gemini CLI, etc.)

Maintainer

Arkava Ltd — [email protected]


License

MIT License - see LICENSE for details.


Links

来源:README.md,提交 6e93f04

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分