伽玛-MCP服务器

Name: 伽玛-MCP服务器
Author: CryptoJym

作者：CryptoJym2 星标更新：2025-09-23

安装使用来源：spider==github.com

项目介绍

Gamma MCP 服务器

开源的模型上下文协议（MCP）服务器，用于Gamma Generate API。此项目允许任何支持MCP的助手（如Claude Desktop、自定义代理等）按需生成Gamma演示文稿、文档或社交卡片——包括主题、图像、导出选项和分享链接。

为什么存在这个项目

Gamma的Web界面非常出色，但重复的任务（如简报、文档变体、活动幻灯片）仍然需要太多点击操作。Gamma MCP服务器通过MCP暴露了完整的Gamma API，使得代理可以：

在几秒钟内原型化想法和幻灯片。
标准化品牌准备好的导出文件（PDF/PPTX）。
让人类专注于反馈，而不是格式化。

该仓库结构感觉“官方”：清晰的安装步骤、可重现的脚本以及指向在此构建过程中生成的资产的实时链接。

功能亮点

任意Gamma工件：通过format生成演示文稿、文档或社交卡片。
文本智能：选择生成还是浓缩，语气，语言，每张卡片的密度。
图像控制：AI生成、Unsplash、Giphy、精选网络选项，加上模型和样式提示。
布局掌握：明确的卡片数量、分割模式、纵横比（16×9, 4×5, Letter等）。
共享与导出：设置工作区/外部权限并请求额外的导出（PDF/PPTX）。
选项目录：gamma_describe_options报告所有接受的枚举值，直接来自代码——无需猜测。
状态+分享链接：gamma_get_status返回实时进度、Gamma URL和信用使用情况。

快速开始

先决条件

Node.js ≥ 18
一个Gamma API密钥（通过Gamma Generate申请）
git

安装

# 1. 克隆
git clone https://github.com/CryptoJym/gamma-mcp-server.git
cd gamma-mcp-server

# 2. 安装依赖
npm install

# 3. 配置环境
cp .env.example .env
# 编辑.env并设置
# GAMMA_API_KEY=sk-gamma-your-key

# 4. 类型检查&构建
npm run build

# 5. 可选烟雾测试（调用实时Gamma API）
GAMMA_API_KEY=sk-gamma-your-key npm run test

注册到MCP客户端（以Claude Desktop为例）

在~/Library/Application Support/Claude/claude_desktop_config.json中添加以下条目：

{
  "mcpServers": {
    "gamma": {
      "command": "node",
      "args": ["/绝对路径/to/gamma-mcp-server/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-key"
      }
    }
  }
}

MCP工具

工具	目的	关键输入
`gamma_generate`	主要生成器，用于演示文稿、文档和社交卡片。	`inputText`，可选旋钮（`format`，`textMode`，`numCards`，`cardOptions.dimensions`，`imageOptions`，`sharingOptions`等）
`gamma_get_status`	查询作业状态、可分享的`gammaUrl`和信用消耗。	`generationId`
`gamma_get_themes`	返回Gamma主题；如果API没有响应，则回退到精选默认值。	无
`gamma_describe_options`	列出接受的枚举值，使提示保持有效。	可选`category`（例如，`imageSources`）和`format`

使用Zod进行模式验证，镜像Gamma的文档（长度限制、枚举强制执行等）。任何验证错误都会作为MCP友好的响应显示。

工作流程示例

1. Utlyze“Open AI Bar”社交促销（多平台资产）

生成Gamma品牌的社交文案/卡片，宣传免费的周二AI诊所。

GAMMA_API_KEY=sk-gamma-your-key \
npx tsx scripts/generate-utlyze-ad.ts

实时资产：https://gamma.app/docs/8hkm743zfnymbrr

2. “Gamma MCP Launchpad”幻灯片（官方概述）

创建一个Gamma主题的演示文稿，解释这个MCP、设置步骤和行动呼吁。

GAMMA_API_KEY=-sk-gamma-your-key \
npx tsx scripts/generate-gamma-overview.ts

实时资产：https://gamma.app/docs/lta8lrr6104aksa

这两个脚本都依赖于共享的GammaClient，等待gammaUrl准备好，并在Gamma标记为完成时打印可分享的链接。

实时运行日志

这些指令是在对话期间执行的，并在此处保留以供透明度：

加固MCP服务器，添加scripts/generate-utlyze-ad.ts，并通过npm run build和npm run test确认输出。
触发Utlyze Open AI Bar促销的实时Gamma任务，并捕获上述分享链接。
编写scripts/generate-gamma-overview.ts以构建官方MCP启动幻灯片，并捕获上述分享链接。
更新README以反映设置、工作流程和实时资产，以便未来用户可以复制确切的过程。

演示或培训新同事时，请使用这些步骤作为检查表——这里版本化的所有内容都是重新生成资产或创建新资产所需的。

贡献指南

欢迎提交问题和PR！建议的贡献：

额外的工作流程脚本（例如，会议记录、投资者幻灯片、周报）。
与调度程序/自动化管道集成，发布Gamma生成的内容。
增强错误处理或缓存主题列表/状态轮询。

提交前：

npm run build
npm run test   # 需要GAMMA_API_KEY