Gamma MCP Pro

Gamma MCP Pro

一个专业的基于类型脚本的MCP（模型上下文协议）服务器，用于使用Gamma API生成演示文稿、文档和社交内容。

🚀 特性

• 伽马含量生成：创建演示文稿、文档和社交媒体内容
• 全面的API支持：完全支持Gamma API v0.2参数
• 多种输出格式：演示文稿、文档和社交媒体内容
• 主题定制：支持各种Gamma主题，包括自定义主题
• 导出选项：PDF和PPTX导出功能
• 高级配置：文本选项、图像选项、卡片布局和共享设置
• 多语言支持：内容生成支持50多种语言
• 灵活的内容输入：支持从简短主题到详细内容的手动卡片拆分

📦 技术栈

• Node.js v18+
• TypeScript 5.x具有严格模式
• MCP-SDK 1.17.x用于模型上下文协议
• API伽马 v0.2用于内容生成
• 萨德 用于运行时类型验证
• ESLint + 更漂亮 代码质量
• pnpm 用于包管理

🛠️ 安装和设置

先决条件

• Node.js v18或更高版本
• pnpm包管理器
• Gamma API密钥

克隆并安装

# Clone the repository
git clone https://github.com/akira-cn/gamma-mcp-pro.git
cd gamma-mcp-pro

# Install dependencies
pnpm install

# Build the project
pnpm build

🔑 配置

环境变量

将Gamma API键设置为环境变量：

export GAMMA_API_KEY="sk-gamma-your-api-key-here"

发展模式

pnpm dev

生产模式

pnpm build
pnpm start

🔧 MCP客户端配置

在您的MCP客户端（例如Claude Desktop）中配置此服务器：

{
  "mcpServers": {
    "gamma-mcp-pro": {
      "command": "npx",
      "args": ["-y", "gamma-mcp-pro"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      }
    }
  }
}

或者在本地运行：

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

🎯 用法

Cursor IDE中的配置

要在CursorIDE中使用此MCP服务器，您需要在Cursor设置中对其进行配置：

1. 打开光标设置首选 Cursor > Settings （或 Cmd/Ctrl + ,)

1. 导航到功能：点击左侧边栏中的“功能”

1. 查找模型上下文协议：查找“模型上下文协议”部分

1. 添加服务器配置：点击“编辑配置”，添加以下配置：

{
  "mcpServers": {
    "gamma-mcp-pro": {
      "command": "npx",
      "args": ["-y", "gamma-mcp-pro"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      }
    }
  }
}

替代方案：本地安装

如果您更喜欢在本地运行服务器：

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

1. 保存并重新启动：保存配置并重新启动Cursor以使更改生效

1. 验证连接：打开一个新聊天，您应该看到Gamma MCP Pro服务器随 generate 工具

基本用法

服务器提供单一 generate 接受内容生成综合参数的工具：

// Example: Generate a presentation about AI productivity
{
  "inputText": "Ways to use AI for productivity in the workplace",
  "format": "presentation",
  "themeName": "Corporate",
  "numCards": 8,
  "textOptions": {
    "tone": "professional",
    "audience": "business executives",
    "amount": "detailed"
  }
}

高级功能

手动分卡

{
  "inputText": "# Introduction\nOverview of AI tools\n---\n# Benefits\nKey advantages\n---\n# Implementation\nStep-by-step guide",
  "cardSplit": "inputTextBreaks"
}

自定义图像生成

{
  "imageOptions": {
    "source": "aiGenerated",
    "model": "imagen-4-pro",
    "style": "photorealistic"
  }
}

导出选项

{
  "exportAs": "pdf", // or "pptx"
  "cardOptions": {
    "dimensions": "16x9"
  }
}

📋 API参数

核心参数

• 输入Text （必填）：要生成的内容（1-750000个字符）
• 格式: presentation | document | social （默认值： presentation)
• 文本模式: generate | condense | preserve （默认值： generate)
• 主题名称：主题名称（默认值： Oasis)
• numCards：卡片数量1-60（默认值：10）
• 卡片拆分: auto | inputTextBreaks （默认值： auto)

高级选项

• text选项：控制语气、受众、语言和内容量
• ImageOptions：配置AI图像生成
• 卡片选项：设置尺寸和布局
• 共享选项：控制访问权限
• 出口A：导出格式(pdf | pptx)
• 附加说明：自定义生成说明

支持的语言

支持50多种语言，包括：

• 英语（en，en-gb，en-in）
• 西班牙语（ES，ES-ES，ES-MX，ES-419）
• 中文（zh-cn，zh-tw）
• 日语（ja，ja da）
• 还有更多。..

🧹 发展

代码质量

# Lint code
pnpm lint
pnpm lint:fix

# Format code
pnpm format
pnpm format:check

项目结构

src/
├── index.ts           # Main MCP server implementation
└── utils/
    └── logger.ts      # Structured logging utility
dist/                  # Compiled output
tests/                 # Test files (if any)
.trae/
├── project_rules.md   # Project technical specifications
└── memory_bank/       # Project development context

📄 脚本

• pnpm build：将TypeScript编译为JavaScript
• pnpm dev：使用ts节点在开发模式下运行
• pnpm start：运行编译的JavaScript
• pnpm lint：使用ESLint检查代码
• pnpm lint:fix：自动修复ESLint问题
• pnpm format：使用Prettier格式化代码
• pnpm format:check：检查代码格式
• pnpm clean：删除dist目录

🔒 安全

• API密钥是通过环境变量处理的
• 没有记录或暴露敏感数据
• 严格的TypeScript配置，确保类型安全
• 使用Zod模式进行输入验证

🤝 贡献

1. 分叉存储库
2. 创建要素分支
3. 按照项目的编码标准进行更改
4. 运行测试和梳理
5. 提交拉取请求

📝 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 链接

• 仓库
• 问题
• API伽马文件
• 模型上下文协议

📊 状态

• ✅ 核心MCP服务器实现
• ✅ 完整的Gamma API v0.2集成
• ✅ 全面的参数验证
• ✅ 错误处理和日志
• ✅ TypeScript严格模式
• ✅ ESLint+预处理配置
• ✅ 生产就绪构建系统

______________________________________________________________________

内置于❤️ 使用TypeScript和模型上下文协议