Gamma MCP Server

Model Context Protocol (MCP) server fr Gamma.app - gr det mjligt fr AI-assistenter att generera presentationer via Gamma API.

Features

• 3 MCP Tools:

• gamma_generate - Skapa presentation/dokument

• gamma_get_generation - Hmta status p generation

• gamma_list_generations - Lista tidigare generationer

• Tv lgen:

• stdio - Fr Claude Desktop (lokal anvndning)

• HTTP - Fr AI Engine & webbapplikationer (24/7 deployment)

• Full Gamma API support:

• Presentations, Documents, Webpages

• Custom themes, tones, audiences

• Swedish language default

• Image generation

Installation

1. Klona/Kopiera projektet

cd ~/gamma-mcp-server

2. Installera dependencies

npm install

3. Konfigurera API key

Uppdatera .env filen med din Gamma API key:

GAMMA_API_KEY=sk-gamma-your-key-here

4. Bygg projektet

npm run build

Anvndning

Lokal testning (stdio mode)

Fr att testa med Claude Desktop eller lokalt:

npm start

Lgg till i Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gamma": {
      "command": "node",
      "args": ["/absolut/skvg/till/gamma-mcp-server/dist/index.js"]
    }
  }
}

HTTP Server (fr AI Engine)

Starta HTTP-servern:

npm run start:streamable

Servern krs p http://localhost:3000/mcp

Deployment till allgot.se

Metod 1: PM2 (Process Manager)

# Installera PM2
npm install -g pm2

# Starta servern
pm2 start dist/streamable-http-server.js --name gamma-mcp

# Auto-restart vid server reboot
pm2 startup
pm2 save

Metod 2: Systemd Service

Skapa /etc/systemd/system/gamma-mcp.service:

[Unit]
Description=Gamma MCP Server
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/home/u210698164/gamma-mcp-server
Environment=NODE_ENV=production
ExecStart=/usr/bin/node dist/streamable-http-server.js
Restart=always

[Install]
WantedBy=multi-user.target

Aktivera:

sudo systemctl enable gamma-mcp
sudo systemctl start gamma-mcp

Nginx Reverse Proxy

Lgg till i nginx config:

location /gamma-mcp {
    proxy_pass http://localhost:3000/mcp;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;

    # Fr SSE streaming
    proxy_buffering off;
    proxy_read_timeout 600s;
}

Integration med AI Engine

1. Via Code Engine Pro

Skapa ett PHP snippet i Code Engine (typ: function):

function gamma_create_presentation($params) {
    $mcp_url = 'https://allgot.se/gamma-mcp';

    $request = [
        'jsonrpc' => '2.0',
        'id' => 1,
        'method' => 'tools/call',
        'params' => [
            'name' => 'gamma_generate',
            'arguments' => $params
        ]
    ];

    $response = wp_remote_post($mcp_url, [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json, text/event-stream'
        ],
        'body' => json_encode($request),
        'timeout' => 60
    ]);

    return json_decode(wp_remote_retrieve_body($response), true);
}

2. Direkt i AI Engine

Om AI Engine stdjer externa MCP servers kan du konfigurera:

• Endpoint: https://allgot.se/gamma-mcp
• Metod: POST
• Headers: Accept: application/json, text/event-stream

API Examples

Skapa presentation

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "gamma_generate",
    "arguments": {
      "inputText": "Hllbar utveckling i skolan",
      "format": "presentation",
      "numCards": 12,
      "textTone": "educational",
      "textAudience": "teachers",
      "textLanguage": "Swedish"
    }
  }
}

Hmta status

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "gamma_get_generation",
    "arguments": {
      "generationId": "gen_abc123"
    }
  }
}

Environment Variables

Security

• Lgg ALDRIG till .env i git
• Anvnd HTTPS i produktion
• Begrnsa access till MCP endpoint (firewall/auth)
• Hll Gamma API key sker

Troubleshooting

Server startar inte

# Kolla om port 3000 redan anvnds
lsof -i :3000

# Prova annan port
PORT=3001 npm run start:streamable

Gamma API errors

# Testa API key manuellt
curl -X POST https://public-api.gamma.app/v1.0/generate \
  -H "X-API-KEY: your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"input_text":"Test","format":"presentation"}'

MCP connection issues

• Kontrollera att Accept: application/json, text/event-stream header finns
• Kolla server logs: pm2 logs gamma-mcp eller journalctl -u gamma-mcp -f
• Verifiera att nginx reverse proxy r korrekt konfigurerad

Support

Fr frgor eller problem, kontakta: isak@allgot.se

License

MIT License - Allgot.se