2slides
官方这是全球首个、最简单且最便宜的PPT、幻灯片、演示文稿AI生成MCP服务器。
你可以用 2slides MCP 做什么?
- 搜索演示主题 — 在生成演示文稿前,使用
themes_search按“商务”或“极简”等关键词查找预建主题。 - 生成主题化 PowerPoint — 调用
slides_generate,传入themeId和内容,即可生成可下载的 PPT,可选择同步或异步模式。 - 创建自定义设计幻灯片 — 使用
slides_create_pdf_slides或slides_create_like_this,从文本或参考图片生成具有自定义样式的 Nano Banana 幻灯片。 - 添加 AI 语音旁白 — 对已完成的 Nano Banana 任务应用
slides_generate_narration,可从 30 种可用声音中选择单人或双人播报。 - 跟踪任务进度 — 每 20 秒轮询
jobs_get以检查状态,并在生成完成时获取下载链接。 - 导出带音频的幻灯片 — 使用
slides_download_slides_pages_voices获取包含页面图像、旁白 WAV 文件和文字记录的 ZIP 压缩包。
文档
2slides MCP 服务器

向 MCP 客户端暴露 2slides.com 的工具:生成 PowerPoint 演示文稿和自定义设计的幻灯片,添加 AI 语音旁白,并将完成的文件以下载链接的形式返回。
获取 API 密钥
连接之前,请从 2slides.com/api 获取 API 密钥。
连接
2slides 运行一个托管的 Streamable HTTP MCP 端点,同时也提供这个 stdio 包。两者在同一个账户和相同的积分体系下暴露相同的 7 个工具。
| Streamable HTTP | stdio(本包) | |
|---|---|---|
| 设置 | 一条命令,无需安装 | 需要 Node.js 18+,npx 获取包 |
| 更新 | 服务端,始终最新 | 在您的机器上重新下载 |
| 运行于 | 任何支持远程的 MCP 客户端 | 任何可以启动本地进程的客户端 |
选项 1 — Streamable HTTP(推荐)
Anthropic 的 MCP 文档称 HTTP 为“连接远程 MCP 服务器的推荐选项”,而 2slides 是一个托管服务,没有需要访问的本地文件或进程,因此从这里开始。
Claude Code
claude mcp add --transport http 2slides "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
使用 claude mcp list 验证 — 服务器应报告 ✔ Connected。
项目配置(.mcp.json,与您的团队共享)
{
"mcpServers": {
"2slides": {
"type": "http",
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}
Claude Desktop / claude.ai:在 claude.ai/customize/connectors 将其添加为自定义连接器,使用相同的 URL。
选项 2 — stdio(本地进程)
当客户端只能启动本地进程、机器无法直接访问 2slides.com,或者您想自行固定和修补服务器时,请使用此选项。
Claude Code
claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest
Claude Desktop — 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(Windows 上为 %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": {
"API_KEY": "YOUR_2SLIDES_API_KEY"
}
}
}
}
-y 标志允许 npx 在无提示的情况下安装包。之后完全重启 Claude Desktop;在聊天中打开工具面板,您应该会看到以下工具。
可用工具
slides_generate(POST /api/v1/slides/generate)
使用预建主题生成 PowerPoint 演示文稿(Fast PPT)。先使用 themes_search 查找 themeId。
- 参数:
userInput(字符串,必填)— 演示文稿内容themeId(字符串,必填)— 来自themes_search的主题 IDresponseLanguage(字符串,可选,默认:Auto)— 输出语言;支持的值:Auto、English、Spanish、Arabic、Portuguese、Indonesian、Japanese、Russian、Hindi、French、German、Greek、Vietnamese、Turkish、Thai、Polish、Italian、Korean、Simplified Chinese、Traditional Chinesemode(可选,默认:sync)—sync立即返回downloadUrl;async返回jobId以使用jobs_get轮询
- 积分: 每页 1 积分
- 示例:
{ "themeId": "st-1756528793701-fcg5fblt2", "userInput": "Generate a 5-slide intro to machine learning", "responseLanguage": "English", "mode": "sync" }
themes_search(GET /api/v1/themes/search)
搜索预建主题以与 slides_generate 一起使用。
- 参数:
query(字符串,必填)— 搜索关键词(例如business、minimal、dark)limit(数字,可选,默认:10,范围:1–100)
- 返回: 主题数组,包含
id、name、description、previewUrl、tags - 积分: 免费
- 示例:
{ "query": "business", "limit": 5 }
jobs_get(GET /api/v1/jobs/{jobId})
轮询作业状态并在就绪时获取结果。
- 参数:
jobId(字符串,必填)
- 返回:
jobId、status(pending/processing/success/failed)、message、downloadUrl(成功时)、slidePageCount、createdAt、updatedAt、duration(毫秒)、jobUrl(仅 Nano Banana 作业) - 积分: 免费
- 注意: 每 20 秒轮询一次,直到
status为success或failed。 - 示例:
{ "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
slides_create_like_this(POST /api/v1/slides/create-like-this)
生成与参考图片风格匹配的幻灯片(Nano Banana)。
- 参数:
userInput(字符串,必填)— 演示文稿内容referenceImageUrl(字符串,必填)— 风格参考图片的 URLresponseLanguage(字符串,可选,默认:Auto)aspectRatio(字符串,可选,默认:16:9)— 有效值:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9resolution(字符串,可选,默认:2K)—1K、2K、4Kpage(数字,可选,默认:0)—0= 自动检测,1–100= 精确页数contentDetail(字符串,可选,默认:standard)—concise或standardmode(字符串,可选,默认:async)—async返回jobId;sync立即返回downloadUrl
- 积分: 每页 100 积分(1K/2K)或每页 200 积分(4K)
- 示例:
{ "userInput": "Create a presentation about AI trends", "referenceImageUrl": "https://example.com/style-reference.jpg", "aspectRatio": "16:9", "resolution": "2K", "page": 5, "contentDetail": "standard", "mode": "async" }
slides_create_pdf_slides(POST /api/v1/slides/create-pdf-slides)
从文本内容生成自定义设计的幻灯片(Nano Banana),无需参考图片。
- 参数:
userInput(字符串,必填)— 演示文稿内容designStyle(字符串,可选)— 视觉样式的自由文本描述;留空使用默认样式responseLanguage(字符串,可选,默认:Auto)aspectRatio(字符串,可选,默认:16:9)— 有效值:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9resolution(字符串,可选,默认:2K)—1K、2K、4Kpage(数字,可选,默认:0)—0= 自动检测,1–100= 精确页数contentDetail(字符串,可选,默认:standard)—concise或standardmode(字符串,可选,默认:async)—async返回jobId;sync立即返回downloadUrl
- 积分: 每页 100 积分(1K/2K)或每页 200 积分(4K)
- 示例:
{ "userInput": "Quarterly business review for Q3 2025", "designStyle": "modern, dark background, bold typography", "aspectRatio": "16:9", "resolution": "2K", "page": 8, "mode": "async" }
slides_generate_narration(POST /api/v1/slides/generate-narration)
为已完成的 Nano Banana 作业(仅限 slides_create_like_this 或 slides_create_pdf_slides;不支持 Fast PPT)添加 AI 语音旁白。始终异步 — 使用 jobs_get 轮询结果。
-
参数(单说话人,
mode: "single"默认):jobId(字符串,必填)— 已完成的 Nano Banana 作业的 UUIDmode(字符串,可选,默认:single)—single或multispeakerName(字符串,可选)— 旁白者名称voice(字符串,可选)— 30 种声音之一(见下方列表)contentMode(字符串,可选,默认:standard)—concise或standardincludeIntro(布尔值,可选,默认:true)
-
参数(双说话人,
mode: "multi"):jobId(字符串,必填)mode(字符串,必填)—multispeaker1Name(字符串,必填)speaker2Name(字符串,必填)speaker1Voice(字符串,可选)— 说话人 1 的声音speaker2Voice(字符串,可选)— 说话人 2 的声音contentMode(字符串,可选,默认:standard)—concise或standard
-
支持的声音(30 种):
Puck、Aoede、Charon、Kore、Fenrir、Zephyr、Leda、Orus、Callirrhoe、Autonoe、Enceladus、Iapetus、Umbriel、Algieba、Despina、Erinome、Algenib、Rasalgethi、Laomedeia、Achernar、Alnilam、Schedar、Gacrux、Pulcherrima、Achird、Zubenelgenubi、Vindemiatrix、Sadachbia、Sadaltager、Sulafat -
积分: 每页 210 积分(10 文本 + 200 音频)
-
示例:
{ "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "multi", "speaker1Name": "Alice", "speaker2Name": "Bob", "speaker1Voice": "Aoede", "speaker2Voice": "Puck", "contentMode": "standard" }
slides_download_slides_pages_voices(POST /api/v1/slides/download-slides-pages-voices)
将幻灯片页面和音频旁白导出为 ZIP 文件。作业必须已完成并生成了旁白。
- 参数:
jobId(字符串,必填)— 已完成旁白的作业的 UUID
- 返回:
downloadUrl(1 小时内过期)、fileName、expiresIn(3600 秒) - ZIP 内容:
pages/ page_01.png, page_02.png, … voices/ page_01.wav, page_02.wav, … transcript.txt - 积分: 免费
- 示例:
{ "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
典型工作流
Fast PPT(基于主题的 PowerPoint):
themes_search→ 获取themeIdslides_generate(同步)→ 直接获取downloadUrl
Nano Banana(自定义设计的幻灯片):
slides_create_like_this或slides_create_pdf_slides(异步)→ 获取jobIdjobs_get(每 20 秒轮询)→ 当status: "success"时获取downloadUrl
带旁白的 Nano Banana:
slides_create_like_this或slides_create_pdf_slides→ 获取jobIdjobs_get→ 等待幻灯片完成slides_generate_narration→ 获取旁白jobIdjobs_get→ 等待旁白完成slides_download_slides_pages_voices→ 获取 ZIP 下载链接
故障排除(Claude Desktop)
- 如果工具未出现在 Claude 中,请验证配置路径是否为绝对路径并重启应用。
- 检查 Claude MCP 日志:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
- 对于 stdio MCP 服务器,避免向 stdout 记录日志;此服务器仅向 stderr 记录错误。
参考
- 构建 MCP 服务器(官方文档):https://modelcontextprotocol.io/docs/develop/build-server
- 2slides API 文档:https://2slides.com/api
- 2slides:https://2slides.com
- 2slides 模板:https://2slides.com/templates