2Slides Logo
如何在 Gemini CLI 中使用 2Slides MCP 服务器(2026 指南)
2Slides Team
3 min read

如何在 Gemini CLI 中使用 2Slides MCP 服务器(2026 指南)

快速答案(≤60 字): Google 的 Gemini CLI 可以通过 2Slides MCP 服务器生成真正的 PowerPoint 文件。先到 2slides.com/api 取得密钥,然后往

~/.gemini/settings.json
加一条
mcpServers
条目——stdio 用
command: "npx"
args: ["2slides-mcp"]
env.API_KEY
,Streamable HTTP 用
httpUrl: "https://2slides.com/api/mcp?apikey=KEY"
。也可以运行
gemini mcp add
。然后让 Gemini 做一份演示文稿即可。

Gemini CLI 是 Google 开源的终端 AI 代理,原生支持 Model Context Protocol(MCP)。把它连接到 2Slides MCP 服务器,Gemini 就能把一个提示词——或你工作目录里的一个文件——变成一份成品、可编辑的

.pptx

本指南给出两种传输方式(本地 stdio 和远程 Streamable HTTP)的具体

settings.json
配置块、
gemini mcp add
快捷方式,以及每个 2Slides 工具的作用。

为什么要把 Gemini CLI 连接到 2Slides?

Gemini 是一个强大的多模态推理器,但它自己产不出二进制的

.pptx
文件。2Slides MCP 服务器正是那个专门的生成器:

  • Gemini CLI 读取你的源材料,规划幻灯片,撰写文案。
  • 2Slides MCP 服务器 渲染出真正的 PowerPoint——基于主题的 Fast PPT,或图片设计型幻灯片,可选 AI 配音和可导出的素材包。

你需要先准备什么

  1. 已安装的 Gemini CLI
    gemini
    在你的 PATH 中)。
  2. 一个来自 2slides.com/api 的 2Slides API 密钥。
  3. Node.js,用于 stdio 传输(
    npx 2slides-mcp
    )。HTTP 传输无需任何本地依赖。

Stdio 还是 Streamable HTTP:该选哪种传输?

两者暴露相同的工具;差别在于配置键和连接器在哪里运行。

Stdio(本地)Streamable HTTP(远程)
配置键
command
/
args
/
env
httpUrl
本地 Node.js需要不需要
适用场景本地开发远程/CI、轻量配置

键名很重要: Gemini CLI 用

httpUrl
表示 Streamable HTTP,用
url
表示旧版 SSE。对于 2Slides 的 Streamable HTTP 端点,请用
httpUrl

方法一:在 settings.json 中配置 stdio

Gemini CLI 读取

~/.gemini/settings.json
(全局)和
.gemini/settings.json
(项目)。加入一个
mcpServers
块:

{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } }

如果你不想把密钥内联进去,

env
的值也可以引用 shell 变量(例如
"API_KEY": "$TWOSLIDES_API_KEY"
)。

方法二:在 settings.json 中配置 Streamable HTTP

对于托管端点,使用

httpUrl

{ "mcpServers": { "2slides-remote": { "httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY" } } }

更喜欢请求头认证?加一个

headers
对象:
"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }

或使用
gemini mcp add
命令

# stdio (-e sets env vars) gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx 2slides-mcp # Streamable HTTP gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

这些命令会把相同的

mcpServers
条目写入
settings.json
。可用标志包括
-t, --transport
(stdio | sse | http)、
-e, --env
-H, --header
--timeout

验证连接

在交互式

gemini
会话中,运行:

/mcp

它会显示每个服务器的状态(CONNECTED / CONNECTING / DISCONNECTED)以及已发现的工具。如果某个远程服务器需要 OAuth,使用

/mcp auth

生成你的第一份演示文稿

直接提要求:

Read ./notes/market-update.md and generate a 9-slide briefing. Find a professional theme from 2slides, build the PowerPoint, and give me the download link.

Gemini CLI 会运行

themes_search
slides_generate
(Fast PPT)→ 返回
downloadUrl
。对于自定义的图片设计型幻灯片,它会使用
slides_create_pdf_slides
,并轮询
jobs_get
直到演示文稿就绪。

2Slides MCP 工具列表

工具作用积分
themes_search
为 Fast PPT 查找
themeId
免费
slides_generate
基于主题的 PowerPoint(Fast PPT),同步/异步10 / 页
slides_create_pdf_slides
由文字生成自定义图片设计型幻灯片(Nano Banana)100 / 页 (1K/2K), 200 (4K)
slides_create_like_this
匹配参考图片风格的幻灯片100 / 页 (1K/2K), 200 (4K)
slides_generate_narration
为 Nano Banana 任务添加 AI 语音配音210 / 页
slides_download_pages_voices
把页面 + 音频导出为 ZIP免费
jobs_get
轮询异步任务直到完成免费

常见错误与排错

  • 给 Streamable HTTP 端点用了
    url
    Gemini CLI 把
    url
    当作 SSE。2Slides 的 Streamable HTTP 请用
    httpUrl
  • 服务器在
    /mcp
    中显示 DISCONNECTED。
    检查 API 密钥,对 stdio 还要确认已安装 Node.js。
  • 没有列出任何工具。 编辑
    settings.json
    后重启会话,或重新运行
    gemini mcp add
  • 没连工具就别想要
    .pptx
    Gemini 单独只起草大纲;2Slides 才产出文件。
  • 轮询太紧凑。 对异步的 Nano Banana / 配音任务,让 Gemini 大约每 20 秒轮询一次
    jobs_get

常见问题

Gemini CLI 支持 MCP 服务器吗?

支持。Gemini CLI 是一个 MCP 客户端。在

~/.gemini/settings.json
mcpServers
下配置服务器,或用
gemini mcp add
添加。stdio、SSE 和 Streamable HTTP 传输全都受支持。

Streamable HTTP 服务器的配置键是什么?

httpUrl
url
仅用于旧版 SSE 服务器。2Slides 的 Streamable HTTP 端点放在
httpUrl
里。

Gemini CLI 把 MCP 配置存在哪里?

~/.gemini/settings.json
(全局)或
.gemini/settings.json
(项目)。MCP 块是顶层的
mcpServers
键。

它会产出真正的 PowerPoint 吗?

会——

slides_generate
返回一个可编辑的
.pptx
。Nano Banana 工具返回图片设计型演示文稿,可选 AI 配音。

密钥和配置在哪里获取?

2slides.com/api?tab=mcp:你的密钥、一份可复制粘贴的配置,以及 Streamable HTTP 端点 URL。

要点总结

一条

mcpServers
条目——本地用
command
,远程用
httpUrl
——就把 Gemini CLI 变成一个幻灯片生成器。用
/mcp
验证,然后直接开口要一份演示文稿。

要看更广的全景,参见 MCP 如何改变演示文稿工作流PowerPoint MCP 服务器生态地图。在用别的终端代理?参见用同一个服务器的 Claude CodeOpenAI CodexQwen Code

2slides.com/api?tab=mcp 取得你的密钥和配置,不到一分钟就能在 Gemini CLI 里生成你的第一份演示文稿。

来源:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free