gezhe-ppt

Gezhe-PPT MCP 服务器通过话题生成 PPT 的能力，核心工具为 generate_ppt_by_topic。服务器通过 API_KEY 验证后，可以在客户端（如 Cherry Studio、Cursor 等）使用提供的 MCP 服务来按给定话题生成 PPT 的预览或分享链接。使用场景包括快速将讨论话题转化为可演示的幻灯片，便于团队协作与演示准备。通过本地执行或 Streamable HTTP 的方式接入后，客户端只需调用相应的 MCP 服务并传入 topic 参数，即可获得 PPT 预览或下载链接。该服务器对话题驱动的 PPT 生成流程简单直观，适合需要将文本内容快速落地为可演示材料的用户。

Prerequisites:

• Node.js (包含 npm 或 npx)
• 访问 Gezhe 并获取 API_KEY 用于认证

本地安装步骤:

1. 安装 Node.js 与 npm/npx，确保环境可用。
2. 在本地或工作区创建一个配置文件，例如 mcp_config.json，或直接在客户端提供如下配置。
3. 获取来自 Gezhe 的 API_KEY（在“设置-MCP 服务器”页面获取），并将其填入 env.VAR 中。
4. 使用如下命令启动 MCP 服务（示例使用 npx 命令）：

# 直接通过 npx 运行最新版本的 Gezhe MCP 服务器
npx -y gezhe-mcp-server@latest

5. 将提供的 mcpServers 配置导入到客户端（Cherry Studio、Cursor 等），并确保 API_KEY、服务端地址等信息正确无误。

6. 在客户端调用 generate_ppt_by_topic，并传入 topic 字段，即可获得 PPT 预览链接或下载链接。

Tips and common issues:

• 确保 API_KEY 安全，避免在公开场景泄露。
• 如果使用本地执行，请确保网络能访问 Gezhe 的服务端以完成 PPT 生成。
• 如遇到连接问题，检查 API_KEY 是否正确、网络是否可达，以及客户端是否指向正确的 MCP 服务 URL。
• 支持的工具仅列出 generate_ppt_by_topic，未来如增加新工具，请更新 mcp_config.json，并按需扩展 Env 变量。