AI导哈

文档生成服务器

Gamma MCP Server是一个开源模型上下文协议（MCP）服务器，用于通过Gamma Generate API按需生成演示文稿、文档或社交卡片，支持主题、图像、导出和分享链接。

  • by CryptoJym
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 CryptoJym/gamma-mcp-server

使用说明

Gamma MCP 服务器

开源模型上下文协议（MCP）服务器 伽马生成API这个项目允许任何具备MCP（可能是指某种特定能力或接口）的助手（如Claude桌面版、自定义代理等）按需生成Gamma演示文稿、文档或社交卡片，包括主题、图像、导出选项和分享链接。

目录

  1. 为什么会有这个存在
  2. 功能亮点
  3. 快速入门
  4. MCP工具
  5. 工作流配方
  6. 实时跑步记录
  7. 做出贡献
  8. 许可证

为什么存在这个

Gamma的网页用户界面非常出色，但重复性任务（摘要、文档变体、活动资料夹）仍然需要过多的点击操作。Gamma MCP服务器通过MCP公开了完整的Gamma API，以便代理可以：

  • 几秒钟内构思原型创意并组建牌组。
  • 标准化品牌就绪出口产品（PDF/PPTX格式）。
  • 让人类专注于反馈，而非格式。

该存储库的设计让人感觉“官方”：安装步骤清晰、脚本可复现，并且提供了此构建过程中生成的资源的实时链接。

功能亮点

  • 任何伽马伪影通过展示、文件或社交名片 format。
  • 文本智能选择生成与凝练、语调、语言、每张卡片的密度。
  • 图像控制由AI生成，来自Unsplash、Giphy，精选网页选项，以及模型和风格提示。
  • 布局掌控明确的卡片数量、拆分模式、宽高比（16:9、4:5、Letter等）。
  • 分享与导出设置工作区/外部权限并请求额外导出（PDF/PPTX）。
  • 选项目录： gamma_describe_options 直接从代码中报告所有接受的枚举值——无需猜测。
  • 状态 + 分享链接： gamma_get_status 返回实时进度、Gamma URL以及信用额度使用情况。

快速入门

先决条件

  • Node.js ≥（表示Node.js版本大于或等于某个版本，但具体版本号未给出） 十八
  • 一个Gamma API密钥（通过请求获得） Gamma 生成）
  • git

安装

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

# 2. Install dependencies
npm install

# 3. Configure environment
cp .env.example .env
# edit .env and set
# GAMMA_API_KEY=sk-gamma-your-key

# 4. Type-check & build
npm run build

# 5. Optional smoke test (hits live 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": ["/absolute/path/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. 利用“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（多渠道计划/营销通信计划等，具体根据上下文确定）、设置步骤以及行动号召（CTAs）。

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

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

两个脚本都依赖于共享的 GammaClient，等待 gammaUrl 准备就绪，一旦Gamma标记运行完成，即打印可分享的链接 completed.

实时运行日志

这些指示是在对话过程中执行的，并在此保留以确保透明度：

  1. 加固了MCP服务器，增加了（安全措施/功能等，具体根据上下文确定） scripts/generate-utlyze-ad.ts，并通过……确认输出结果 npm run build 和 npm run test.
  2. 为Utlyze Open AI Bar促销活动触发了一个实时Gamma作业，并截取了上方的分享链接。
  3. 撰写 scripts/generate-gamma-overview.ts 建立官方的MCP发布页面，并获取了上面的分享链接。
  4. 更新了README文件，以反映设置、工作流程和实时资源，以便未来用户能够复现整个过程。

在演示或新团队成员入职时，使用这些步骤作为核对清单——这里包含了重新生成资产或创建新资产所需的一切内容，并且都已版本化。

做出贡献

欢迎提出问题和提交拉取请求（PR）！建议的贡献包括：

  • 额外的工作流程脚本（例如，会议记录、投资者演示文稿、周报）。
  • 与调度程序/自动化流水线集成，以发布Gamma生成的内容。
  • 增强主题列表/状态轮询的错误处理或缓存功能。

提交前：

npm run build
npm run test   # requires GAMMA_API_KEY

许可证

麻省理工学院（MIT）许可证 © Utlyze / CryptoJym。在注明原始仓库的情况下，欢迎自由改编以用于您自己的MCP工具开发。

相关 MCP