gamma-mcp-pro

akira-cn/gamma-mcp-pro

3.2

If you are the rightful owner of gamma-mcp-pro and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Gamma MCP Pro is a professional TypeScript-based MCP server designed for generating presentations, documents, and social content using the Gamma API.

Gamma MCP Pro

A professional TypeScript-based MCP (Model Context Protocol) server for generating presentations, documents, and social content using the Gamma API.

🚀 Features

  • Gamma Content Generation: Create presentations, documents, and social media content
  • Comprehensive API Support: Full support for Gamma API v0.2 parameters
  • Multiple Output Formats: Presentations, documents, and social media content
  • Theme Customization: Support for various Gamma themes including custom themes
  • Export Options: PDF and PPTX export functionality
  • Advanced Configuration: Text options, image options, card layouts, and sharing settings
  • Multi-language Support: 50+ languages supported for content generation
  • Flexible Content Input: Support for brief topics to detailed content with manual card splitting

📦 Tech Stack

  • Node.js v18+
  • TypeScript 5.x with strict mode
  • MCP SDK 1.17.x for Model Context Protocol
  • Gamma API v0.2 for content generation
  • Zod for runtime type validation
  • ESLint + Prettier for code quality
  • pnpm for package management

🛠️ Installation & Setup

Prerequisites

  • Node.js v18 or higher
  • pnpm package manager
  • Gamma API key

Clone and Install

# 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

🔑 Configuration

Environment Variables

Set your Gamma API key as an environment variable:

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

Development Mode

pnpm dev

Production Mode

pnpm build
pnpm start

🔧 MCP Client Configuration

Configure this server in your MCP client (e.g., Claude Desktop):

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

Or run locally:

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

🎯 Usage

Configuration in Cursor IDE

To use this MCP server in Cursor IDE, you need to configure it in your Cursor settings:

  1. Open Cursor Settings: Go to Cursor > Settings (or Cmd/Ctrl + ,)

  2. Navigate to Features: Click on "Features" in the left sidebar

  3. Find Model Context Protocol: Look for the "Model Context Protocol" section

  4. Add Server Configuration: Click "Edit Config" and add the following configuration:

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

Alternative: Local Installation

If you prefer to run the server locally:

{
  "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. Save and Restart: Save the configuration and restart Cursor for changes to take effect

  2. Verify Connection: Open a new chat and you should see the Gamma MCP Pro server available with the generate tool

Basic Usage

The server provides a single generate tool that accepts comprehensive parameters for content generation:

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

Advanced Features

Manual Card Splitting
{
  "inputText": "# Introduction\nOverview of AI tools\n---\n# Benefits\nKey advantages\n---\n# Implementation\nStep-by-step guide",
  "cardSplit": "inputTextBreaks"
}
Custom Image Generation
{
  "imageOptions": {
    "source": "aiGenerated",
    "model": "imagen-4-pro",
    "style": "photorealistic"
  }
}
Export Options
{
  "exportAs": "pdf", // or "pptx"
  "cardOptions": {
    "dimensions": "16x9"
  }
}

📋 API Parameters

Core Parameters

  • inputText (required): Content to generate from (1-750,000 characters)
  • format: presentation | document | social (default: presentation)
  • textMode: generate | condense | preserve (default: generate)
  • themeName: Theme name (default: Oasis)
  • numCards: Number of cards 1-60 (default: 10)
  • cardSplit: auto | inputTextBreaks (default: auto)

Advanced Options

  • textOptions: Control tone, audience, language, and content amount
  • imageOptions: Configure AI image generation
  • cardOptions: Set dimensions and layout
  • sharingOptions: Control access permissions
  • exportAs: Export format (pdf | pptx)
  • additionalInstructions: Custom generation instructions

Supported Languages

Supports 50+ languages including:

  • English (en, en-gb, en-in)
  • Spanish (es, es-es, es-mx, es-419)
  • Chinese (zh-cn, zh-tw)
  • Japanese (ja, ja-da)
  • And many more...

🧹 Development

Code Quality

# Lint code
pnpm lint
pnpm lint:fix

# Format code
pnpm format
pnpm format:check

Project Structure

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

📄 Scripts

  • pnpm build: Compile TypeScript to JavaScript
  • pnpm dev: Run in development mode with ts-node
  • pnpm start: Run compiled JavaScript
  • pnpm lint: Check code with ESLint
  • pnpm lint:fix: Auto-fix ESLint issues
  • pnpm format: Format code with Prettier
  • pnpm format:check: Check code formatting
  • pnpm clean: Remove dist directory

🔒 Security

  • API keys are handled through environment variables
  • No sensitive data is logged or exposed
  • Strict TypeScript configuration for type safety
  • Input validation using Zod schemas

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes following the project's coding standards
  4. Run tests and linting
  5. Submit a pull request

📝 License

MIT License - see the file for details.

🔗 Links

📊 Status

  • ✅ Core MCP server implementation
  • ✅ Full Gamma API v0.2 integration
  • ✅ Comprehensive parameter validation
  • ✅ Error handling and logging
  • ✅ TypeScript strict mode
  • ✅ ESLint + Prettier configuration
  • ✅ Production-ready build system

Built with ❤️ using TypeScript and the Model Context Protocol