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 分