presentations

Alai - AI 演示文稿制作工具 MCP 服务

面向 Claude、Cursor 和 MCP 客户端的 AI 演示文稿制作工具和幻灯片生成器。只需输入文本，即可创建设计师级别的演示文稿、路演演示文稿和幻灯片。可导出为 PowerPoint（PPTX）和 PDF。

什么是 Alai？

Alai 是一款 AI 演示文稿制作工具，无需设计技能，也能快速创建高质量、精美的幻灯片。

• 根据文本生成幻灯片 - 将笔记、markdown、URL 或文档转换为精美的演示文稿
• 美化现有幻灯片 - 借助 AI 为 PowerPoint 演示文稿重新设计样式并进行优化
• 随处导出 - 下载为 PowerPoint（PPTX）、PDF，或生成可分享的链接
• 专业主题 - 适用于各种场合的设计师级别模板
• 演讲者备注 - 为每张幻灯片自动生成 AI 演讲要点
• Nano Banana Pro 图片幻灯片 - 生成与演示文稿视觉风格匹配的主题感知型图片幻灯片
• 编辑并迭代 - 针对现有幻灯片，对文本、图标和图片进行定向修改

使用场景

• 路演演示文稿 - 根据笔记创建可供投资者查看的演示文稿
• 销售演示文稿 - 为潜在客户生成引人注目的幻灯片
• 将会议笔记转换为幻灯片 - 将笔记转化为可分享的演示文稿
• 美化 PowerPoint - 使用专业主题为现有幻灯片重新设计样式
• 营销演示文稿 - 快速制作产品和营销活动演示文稿

功能

• 根据文本、markdown 或会议笔记生成设计师级别的演示文稿
• 由 AI 驱动的幻灯片美化和样式重塑
• 导出为 PowerPoint（PPTX）或 PDF
• 专业路演演示文稿主题
• 在现有演示文稿中添加和删除幻灯片
• 使用定向提示词编辑现有幻灯片并进行迭代
• 自动生成演讲者备注

服务 URL

https://slides-api.getalai.com/mcp/

Glama / 本地包装器

此代码库包含一个本地 MCP 包装器，供 Glama 自动构建、启动和检查服务。

该包装器通过 stdio 运行，并将工具调用转发到托管的 Alai MCP 端点：

• ALAI_MCP_URL - 可选，用于覆盖上游 MCP URL
• ALAI_API_KEY - 可选，用于向上游转发工具调用的 API 密钥
• api_key - 支持 Glama 占位参数的备用环境变量名称

无需凭据即可检查工具，这足以让 Glama 检查服务。实际执行工具需要有效的 API 密钥。

本地运行

npm install
npm start

使用上游凭据：

ALAI_API_KEY=sk_your_key npm start

身份验证

服务在同一端点上接受静态 API 密钥或 OAuth 2.1 bearer token。

API 密钥

从 getalai.com 获取密钥，并通过以下任一请求头传入：

• api-key: sk_your_key
• Authorization: Bearer sk_your_key

OAuth 2.1 与动态客户端注册

服务实现了 RFC 9728 受保护资源元数据，并将授权委托给 Supabase。Supabase 支持 RFC 7591 动态客户端注册和 PKCE（S256）。符合规范的 MCP 客户端（例如 Claude Desktop、MCP Inspector）可以自动发现此流程：

GET https://slides-api.getalai.com/.well-known/oauth-protected-resource

响应中的 authorization_servers 条目指向 Supabase 授权服务器，其 /.well-known/oauth-authorization-server 文档会公布 registration_endpoint、authorization_endpoint 和 token_endpoint。完成授权码 + PKCE 流程后，客户端会向 MCP 端点发送 Authorization: Bearer <jwt>。

可用工具

工具	描述
ping	验证你的 API 密钥并返回你的用户 ID
generate_presentation	根据文本内容创建演示文稿
get_generation_status	查看异步操作状态
get_themes	列出已认证用户可用的主题
get_vibes	列出已认证用户可用的视觉风格
get_presentations	列出你的所有演示文稿
create_slide	向现有演示文稿添加幻灯片（经典或创意）
delete_slide	从演示文稿中移除幻灯片
export_presentation	导出为 PDF、PPTX 或可分享链接
generate_transcripts	为幻灯片生成演讲者备注
delete_presentation	永久删除演示文稿

工作流

1. 使用你的内容调用 generate_presentation
2. 每隔 2-5 秒轮询一次 get_generation_status，直到状态为 completed
3. 使用返回的 presentation_id 进行后续操作

使用示例

生成演示文稿

先调用 get_themes 和 get_vibes，查看你的账户可用的 ID，然后将它们传入：

{
  "input_text": "Benefits of AI in the workplace: increased productivity, enhanced creativity, improved efficiency",
  "title": "AI in the Workplace",
  "theme_id": "<id from get_themes>",
  "vibe_id": "<id from get_vibes>",
  "slide_range": "2-5",
  "include_ai_images": true,
  "num_creative_variants": 1,
  "total_variants_per_slide": 1,
  "image_ids": [],
  "export_formats": ["link"],
  "language": "English"
}

只需提供 input_text。num_creative_variants 必须为 0–2（使用 vibe_id 时需设为 ≥1）。total_variants_per_slide 必须为 1–4。export_formats 接受 "link"、"pdf"、"ppt"。

查看生成状态

{
  "generation_id": "abc123-def456"
}

导出演示文稿

{
  "presentation_id": "xyz789",
  "formats": ["pdf", "link"]
}

可用主题

调用 get_themes 可查看你的账户可用的主题（会返回主题 ID 和显示名称）。以下是一些内置的旧版主题名称，可直接作为 theme_id 传入：

• AURORA_FLUX
• MIDNIGHT_EMBER
• EMERALD_FOREST
• DESERT_BLOOM
• DONUT
• OAK
• PRISMATICA
• SIMPLE_LIGHT
• SIMPLE_DARK
• CYBERPUNK

配置

适用于 Claude Desktop / MCP 客户端

支持 OAuth 的客户端（Claude Desktop、MCP Inspector、Cursor 等）只需使用 URL 即可——客户端会在首次连接时自动发现并运行 OAuth 2.1 + DCR 流程：

{
  "mcpServers": {
    "alai-presentations": {
      "url": "https://slides-api.getalai.com/mcp/",
      "transport": "streamable-http"
    }
  }
}

如果你希望跳过 OAuth 并使用静态 API 密钥，请添加一个 header 块：

{
  "mcpServers": {
    "alai-presentations": {
      "url": "https://slides-api.getalai.com/mcp/",
      "transport": "streamable-http",
      "headers": {
        "api-key": "sk_your_api_key"
      }
    }
  }
}

链接

• 网站
• 获取 API 密钥
• API 文档

许可证

MIT License - 详情请参阅 LICENSE 文件。