Gamma

@mindstone/mcp-server-gamma

Gamma のプレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿の作成、テーマやフォルダーの一覧表示、非同期の生成／エクスポート状況のポーリングに対応する Gamma MCP サーバーです。

すでに管理している API キーを使い、ローカルパッケージから Gamma のデッキやエクスポートを作成したい MCP ホストに最適です。

ステータス

• バージョン： 0.4.1 · npm
• 認証： API キー（GAMMA_API_KEY）
• ツール： 6（テーマ、フォルダー、生成）
• サーフェス： cloud-api
• 機械可読： STATUS.json

このパッケージの目的

Gamma のホスト型 MCP サーバーは、ノーコードやリモートコネクターを使うワークフローに最も簡単な方法です。このパッケージは、npm パッケージと API キーをすでに管理しているローカル MCP ホスト向けです。

アシスタントに、Gamma での便利な作成ワークフローを提供します。テーマやフォルダーを選び、デッキ／ドキュメント／ウェブページの生成を開始し、完了を待って、Gamma のリンクまたはエクスポートした PDF／PPTX を返します。利点はシンプルです。ホストを離れることなく、プロンプトを実用的な Gamma アセットに変換できます。

使用例

「会社のテーマを使って第 4 四半期の業績に関する投資家向けアップデートを 10 枚のスライドで作成し、PPTX としてエクスポートしてください。」

ホストが呼び出すツール：

1. gamma_list_themes — カスタムテーマ ID を検索します。
2. gamma_generate — export_as: "pptx" を指定してプレゼンテーションの生成を開始します。
3. gamma_get_status — Gamma がデッキとエクスポートを完了するまでポーリングします。

応答（一部抜粋）：

{
  "generation_id": "gen_123",
  "status": "completed",
  "gamma_url": "<untrusted-content source=\"gamma:generation.url\">https://gamma.app/docs/...</untrusted-content>",
  "pptx_url": "<untrusted-content source=\"gamma:generation.url\">https://...</untrusted-content>",
  "file_path": "/tmp/gamma_export_gen_123_abcd.pptx"
}

外部文字列（テーマ／フォルダー名、テーマキーワード、ステータスのエラーテキスト、URL）は、モデルが指示ではなくデータとして扱うよう、<untrusted-content> エンベロープ内で返されます。

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストで次の値を入力するよう求められます：GAMMA_API_KEY、GAMMA_EXPORT_POLL_INTERVAL_MS、GAMMA_EXPORT_POLL_MAX_ATTEMPTS、GAMMA_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Gamma": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-gamma"
      ],
      "env": {
        "GAMMA_API_KEY": "",
        "GAMMA_EXPORT_POLL_INTERVAL_MS": "5000",
        "GAMMA_EXPORT_POLL_MAX_ATTEMPTS": "12",
        "GAMMA_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/gamma
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-gamma

ローカル

node dist/index.js

設定

環境変数

• GAMMA_API_KEY — Gamma API キー
• GAMMA_EXPORT_POLL_INTERVAL_MS — エクスポートのポーリング間隔（ミリ秒、デフォルト：5000）
• GAMMA_EXPORT_POLL_MAX_ATTEMPTS — エクスポートのポーリング最大試行回数（デフォルト：12）
• GAMMA_REQUEST_TIMEOUT_MS — Gamma API とホストブリッジの呼び出しの両方に適用される、送信 HTTP リクエストのタイムアウトを上書きするオプション（正の整数のミリ秒、最大 30 分）です。デフォルト：60000（60 秒）。送信に時間がかかるときに TIMEOUT エラーが発生する場合は値を大きくし、より厳密な上限を設けたい場合は値を小さくしてください。
• MCP_HOST_BRIDGE_STATE — ホストが用意している場合に、認証情報の管理に使用するホスト管理のブリッジ状態ファイルです。通常の手動セットアップでは必要ありません。
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE との後方互換性のある別名です。

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Gamma": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-gamma"],
      "env": {
        "GAMMA_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル開発（npm で公開する必要はありません）

{
  "mcpServers": {
    "Gamma": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/gamma/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "your-api-key"
      }
    }
  }
}

ツール（6）

設定

• configure_gamma_api_key — Gamma API キーを設定します

一覧表示

• gamma_list_themes — 利用可能な Gamma テーマ（カスタムおよび標準）を一覧表示します
• gamma_list_folders — ユーザーの Gamma ワークスペース内のフォルダーを一覧表示します

生成

• gamma_generate — AI を活用してプレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿を作成します
• gamma_create_from_template — AI を使用して既存の Gamma ドキュメントを複製し、変更します
• gamma_get_status — Gamma の生成状況をポーリングします

セキュリティに関する注意事項

• Gamma API の呼び出しでは、GAMMA_API_KEY を x-api-key ヘッダーとして使用します。
• configure_gamma_api_key は、キーをメモリに保存するか、MCP_HOST_BRIDGE_STATE が存在する場合はホストブリッジに渡すことができます。
• ホストブリッジが設定されている場合、リクエストはブリッジ状態ファイルのトークンを使用して 127.0.0.1 に送信されます。
• gamma_list_themes / gamma_list_folders が返すテーマ名、フォルダー名、テーマのキーワード配列は、ワークスペースで作成されたテキストです。これらは <untrusted-content> エンベロープで囲まれ、モデルが指示ではなくデータとして扱うようになっています。ベンダーが追加した未知のレスポンスフィールドは、フェイルクローズ方式の Zod 検証によって除去され、ベンダーのエラーボディがログやモデルから見えるエラーに書き込まれることはありません。
• PDF/PPTX のエクスポートは、Gamma が提供する URL からシステムの一時ディレクトリにダウンロードされます。送信リクエストを行う前にエクスポート URL を検証します。HTTPS のみを許可し、ユーザー情報を含む URL、プライベート／ループバック／予約済みホストを拒否し、ホストを gamma.app とそのサブドメインに制限します。リダイレクトは手動でたどり、各ホップを同じ検証で再確認します。また、ダウンロードはアトミックに書き込まれます（予測不能なパスに排他的かつ no-follow で作成し、モードは 0600）。
• 生成機能はユーザーの Gamma ワークスペースにコンテンツを作成し、Gamma クレジットを消費する場合があります。また、ワークスペース内または外部との共有オプションを設定できます。そのため、生成ツールには destructiveHint: true の注釈が付けられています。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来 MIT ライセンスに移行します。本ソフトウェアは 2030-04-08 に MIT ライセンスに移行します。