Gamma MCP Server

Model Context Protocol (MCP) server för Gamma.app - gör det möjligt för AI-assistenter att generera presentationer via Gamma API.

Features

✅ 3 MCP Tools:
- gamma_generate - Skapa presentation/dokument
- gamma_get_generation - Hämta status på generation
- gamma_list_generations - Lista tidigare generationer
✅ Två lägen:
- stdio - För Claude Desktop (lokal användning)
- HTTP - För 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

Användning

Lokal testning (stdio mode)

För att testa med Claude Desktop eller lokalt:

npm start

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

{ "mcpServers": { "gamma": { "command": "node", "args": ["/absolut/sökväg/till/gamma-mcp-server/dist/index.js"] } } }

HTTP Server (för AI Engine)

Starta HTTP-servern:

npm run start:streamable

Servern körs 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

Lägg 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; # För 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 stödjer 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": "Hållbar utveckling i skolan", "format": "presentation", "numCards": 12, "textTone": "educational", "textAudience": "teachers", "textLanguage": "Swedish" } } }

Hämta status

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

Environment Variables

Variable	Beskrivning	Default
`GAMMA_API_KEY`	Din Gamma API key (REQUIRED)	-
`GAMMA_API_BASE_URL`	Gamma API bas-URL	`https://public-api.gamma.app/v1.0`
`PORT`	HTTP server port	`3000`
`HOST`	HTTP server host	`0.0.0.0`
`NODE_ENV`	Environment mode	`development`

Security

⚠️ Lägg ALDRIG till
✅ Använd HTTPS i produktion
✅ Begränsa access till MCP endpoint (firewall/auth)
✅ Håll Gamma API key säker

Troubleshooting

Server startar inte

# Kolla om port 3000 redan används 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

För frågor eller problem, kontakta: isak@allgot.se

License

MIT License - Allgot.se

Gamma MCP Server

Gamma MCP Server

Features

Installation

1. Klona/Kopiera projektet

2. Installera dependencies

3. Konfigurera API key

4. Bygg projektet

Användning

Lokal testning (stdio mode)

HTTP Server (för AI Engine)

Deployment till allgot.se

Metod 1: PM2 (Process Manager)

Metod 2: Systemd Service

Nginx Reverse Proxy

Integration med AI Engine

1. Via Code Engine Pro

2. Direkt i AI Engine

API Examples

Skapa presentation

Hämta status

Environment Variables

Security

Troubleshooting

Server startar inte

Gamma API errors

MCP connection issues

Support

License

Related Resources

New MCP Servers

MCP directory API