把 PPTAgent 接入 Claude 与 CursorMCP Server 配置全攻略【免费下载链接】PPTAgent项目地址: https://gitcode.com/icip-cas/PPTAgentPPTAgent 是一款能把文档自动转成 PPT 的开源 AI 智能体框架而它的MCP Server让你可以把 PPTAgent 直接接入 Claude、Cursor 等 AI 客户端只需一份简单的 JSON 配置就能用自然语言指挥 AI 在聊天窗口里挑选模板、逐页生成幻灯片并导出.pptx文件。本文是一份面向新手的完整教程从环境准备到 Claude / Cursor 的 MCP 配置步骤再到工具调用顺序与常见问题排查带你 10 分钟完成接入。PPTAgent MCP Server 是什么为什么值得接入PPTAgent 的核心思路是先解析参考 PPT再逐页生成解析阶段提取参考幻灯片的版式与结构生成阶段根据文档内容选择版式、生成内容并落到真实可编辑的 PPTX 文件中。完整的生成管线如下图所示。MCPModel Context Protocol模型上下文协议是目前 AI 客户端如 Claude、Cursor连接外部工具的通用接口。PPTAgent 通过 pptagent/mcp_server.py 内置了一个 MCP Server把 PPT 生成能力封装成 7 个标准工具工具名作用list_templates列出所有可用 PPT 模板set_template按名称选择模板需先调用create_slide指定版式创建一张幻灯片write_slide按内容 Schema 写入该页的文本/图片元素generate_slide真正渲染生成这一页save_generated_slides导出所有已生成幻灯片为 PPTX 文件markdown_table_to_image把 Markdown 表格转成图片方便插图也就是说接入之后你不需要打开命令行直接对 AI 说用 default 模板给我做一份 8 页的季度汇报AI 就会自动按set_template → create_slide → write_slide → generate_slide → save_generated_slides的顺序完成全部工作。快速准备安装 pptagent 并启动 MCP ServerMCP Server 的启动入口是pptagent-mcp命令它由 pyproject.toml 中的pptagent-mcp pptagent.mcp_server:main注册。环境要求Python 3.11、uv 包管理器支持 Linux 与 macOSWindows 请使用 WSL。第 1 步安装 uvcurl -LsSf https://astral.sh/uv/install.sh | sh第 2 步设置 3 个模型环境变量并启动服务export PPTAGENT_MODELopenai/gpt-4.1 export PPTAGENT_API_BASEhttp://localhost:8000/v1 export PPTAGENT_API_KEYyour_key uv run --with pptagent pptagent-mcp三个环境变量分别指定使用的模型名、OpenAI 兼容接口的地址、接口密钥。如果你已经在仓库里准备过 DeepPresenter 的配置文件参考 deeppresenter/config.yaml.example也可以改用CONFIG_FILE环境变量指向该配置服务端会从中读取模型端点源码见 mcp_server.py。启动后终端会挂起不退出——这是正常的说明 MCP Server 正等待 AI 客户端连接。 小贴士语言模型建议 70B 参数以上需支持结构化输出视觉模型 7B 即可详见 pptagent/DOC.md。Claude MCP 配置方法mcp.json 示例在 Claude Desktop 中打开配置文件claude_desktop_config.json加入如下片段即可完整示例见 pptagent/DOC.md 的 MCP Server 一节{ mcpServers: { pptagent: { command: uv, args: [ run, --with, pptagent, pptagent-mcp ], env: { PPTAGENT_MODEL: openai/gpt-4.1, PPTAGENT_API_BASE: http://localhost:8000/v1, PPTAGENT_API_KEY: your_key } } } }配置要点说明commandargs让 Claude 用uv run --with pptagent临时拉取 pptagent 包并启动 MCP Server无需你手动建虚拟环境env模型参数也可以写在这里不必依赖系统环境变量保存后重启 Claude在对话输入框附近应能看到 PPTAgent 的图标或 7 个工具已被加载。Cursor MCP 配置最快接入步骤Cursor 的 MCP 配置入口在Settings → Tools MCP → Add New MCP Server生成的mcp.json结构与上面完全一致直接复用即可{ mcpServers: { pptagent: { command: uv, args: [run, --with, pptagent, pptagent-mcp], env: { PPTAGENT_MODEL: openai/gpt-4.1, PPTAGENT_API_BASE: http://localhost:8000/v1, PPTAGENT_API_KEY: your_key } } } }⚠️ 注意在 Cursor 中填写的路径必须是绝对路径例如PPTAGENT_API_KEY所在工作目录生成文件时 AI 会把 PPTX 保存到你工作区的相对路径下。保存后重启 Cursor在 Agent 模式聊天窗口的 MCP 面板中能看到pptagent服务器处于连接状态即配置成功。接入后怎么用一条典型的对话流程接入成功后推荐的提示词结构是模板 页数 主题例如用 list_templates 看看有哪些模板选 default帮我做一份关于小米 SU7 外观与价格的 6 页 PPT最后保存为 su7.pptx。AI 会依次调用工具先list_templates查看模板描述 →set_template(default)→ 对每一页循环create_slide选择版式→write_slide按返回的 Schema 填写内容→generate_slide→ 最后save_generated_slides(su7.pptx)。生成的效果类似上图所示的深色主题数据页。几个使用建议模板怎么选仓库内置 6 套模板位于 pptagent/templates/包括default通用深绿主题、beamer学术报告风、thu、ucas、hit、cip高校/学术机构风格。让 AI 先调用list_templates阅读每套模板的英文描述再决定一次只改一处set_template会被 AI 反复调用时清空所有未保存的幻灯片见 mcp_server.py所以选好模板前别急着生成文字长短控制每页文本量参考 pptagent/BESTPRACTICE.md 中length_factor的说明中英文混排时可调参避免溢出。常见问题排查清单现象原因与解决办法启动时报 Unable to connect to the model三个环境变量任一有误先手动curl $PPTAGENT_API_BASE/models验证连通性Claude/Cursor 里看不到 pptagent 工具检查command是否指向 uv 的绝对路径保存后记得重启客户端Windows 下无法运行项目不支持原生 Windows请切换到 WSL生成到一半 PPT 被清空是 AI 重复调用了set_template重新生成即可生成后及时save_generated_slides某页报 Element xxx not foundwrite_slide的 Schema 填写不完整让 AI 按报错信息补齐该元素后重试总结把 PPTAgent 接入 Claude 或 Cursor 只需要三步用 uv 安装并设置PPTAGENT_MODEL/PPTAGENT_API_BASE/PPTAGENT_API_KEY在客户端的 MCP 配置中粘贴上面的 JSON 片段并重启用一句自然语言模板 页数 主题开始生成导出 PPTX。配置细节可对照 pptagent/DOC.md服务端逻辑与 7 个工具定义都在 pptagent/mcp_server.py 中想深度定制例如替换模板或加新工具从这里入手即可。祝你早日让 AI 替你做完每一页 PPT 【免费下载链接】PPTAgent项目地址: https://gitcode.com/icip-cas/PPTAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
把 PPTAgent 接入 Claude 与 Cursor：MCP Server 配置全攻略
把 PPTAgent 接入 Claude 与 CursorMCP Server 配置全攻略【免费下载链接】PPTAgent项目地址: https://gitcode.com/icip-cas/PPTAgentPPTAgent 是一款能把文档自动转成 PPT 的开源 AI 智能体框架而它的MCP Server让你可以把 PPTAgent 直接接入 Claude、Cursor 等 AI 客户端只需一份简单的 JSON 配置就能用自然语言指挥 AI 在聊天窗口里挑选模板、逐页生成幻灯片并导出.pptx文件。本文是一份面向新手的完整教程从环境准备到 Claude / Cursor 的 MCP 配置步骤再到工具调用顺序与常见问题排查带你 10 分钟完成接入。PPTAgent MCP Server 是什么为什么值得接入PPTAgent 的核心思路是先解析参考 PPT再逐页生成解析阶段提取参考幻灯片的版式与结构生成阶段根据文档内容选择版式、生成内容并落到真实可编辑的 PPTX 文件中。完整的生成管线如下图所示。MCPModel Context Protocol模型上下文协议是目前 AI 客户端如 Claude、Cursor连接外部工具的通用接口。PPTAgent 通过 pptagent/mcp_server.py 内置了一个 MCP Server把 PPT 生成能力封装成 7 个标准工具工具名作用list_templates列出所有可用 PPT 模板set_template按名称选择模板需先调用create_slide指定版式创建一张幻灯片write_slide按内容 Schema 写入该页的文本/图片元素generate_slide真正渲染生成这一页save_generated_slides导出所有已生成幻灯片为 PPTX 文件markdown_table_to_image把 Markdown 表格转成图片方便插图也就是说接入之后你不需要打开命令行直接对 AI 说用 default 模板给我做一份 8 页的季度汇报AI 就会自动按set_template → create_slide → write_slide → generate_slide → save_generated_slides的顺序完成全部工作。快速准备安装 pptagent 并启动 MCP ServerMCP Server 的启动入口是pptagent-mcp命令它由 pyproject.toml 中的pptagent-mcp pptagent.mcp_server:main注册。环境要求Python 3.11、uv 包管理器支持 Linux 与 macOSWindows 请使用 WSL。第 1 步安装 uvcurl -LsSf https://astral.sh/uv/install.sh | sh第 2 步设置 3 个模型环境变量并启动服务export PPTAGENT_MODELopenai/gpt-4.1 export PPTAGENT_API_BASEhttp://localhost:8000/v1 export PPTAGENT_API_KEYyour_key uv run --with pptagent pptagent-mcp三个环境变量分别指定使用的模型名、OpenAI 兼容接口的地址、接口密钥。如果你已经在仓库里准备过 DeepPresenter 的配置文件参考 deeppresenter/config.yaml.example也可以改用CONFIG_FILE环境变量指向该配置服务端会从中读取模型端点源码见 mcp_server.py。启动后终端会挂起不退出——这是正常的说明 MCP Server 正等待 AI 客户端连接。 小贴士语言模型建议 70B 参数以上需支持结构化输出视觉模型 7B 即可详见 pptagent/DOC.md。Claude MCP 配置方法mcp.json 示例在 Claude Desktop 中打开配置文件claude_desktop_config.json加入如下片段即可完整示例见 pptagent/DOC.md 的 MCP Server 一节{ mcpServers: { pptagent: { command: uv, args: [ run, --with, pptagent, pptagent-mcp ], env: { PPTAGENT_MODEL: openai/gpt-4.1, PPTAGENT_API_BASE: http://localhost:8000/v1, PPTAGENT_API_KEY: your_key } } } }配置要点说明commandargs让 Claude 用uv run --with pptagent临时拉取 pptagent 包并启动 MCP Server无需你手动建虚拟环境env模型参数也可以写在这里不必依赖系统环境变量保存后重启 Claude在对话输入框附近应能看到 PPTAgent 的图标或 7 个工具已被加载。Cursor MCP 配置最快接入步骤Cursor 的 MCP 配置入口在Settings → Tools MCP → Add New MCP Server生成的mcp.json结构与上面完全一致直接复用即可{ mcpServers: { pptagent: { command: uv, args: [run, --with, pptagent, pptagent-mcp], env: { PPTAGENT_MODEL: openai/gpt-4.1, PPTAGENT_API_BASE: http://localhost:8000/v1, PPTAGENT_API_KEY: your_key } } } }⚠️ 注意在 Cursor 中填写的路径必须是绝对路径例如PPTAGENT_API_KEY所在工作目录生成文件时 AI 会把 PPTX 保存到你工作区的相对路径下。保存后重启 Cursor在 Agent 模式聊天窗口的 MCP 面板中能看到pptagent服务器处于连接状态即配置成功。接入后怎么用一条典型的对话流程接入成功后推荐的提示词结构是模板 页数 主题例如用 list_templates 看看有哪些模板选 default帮我做一份关于小米 SU7 外观与价格的 6 页 PPT最后保存为 su7.pptx。AI 会依次调用工具先list_templates查看模板描述 →set_template(default)→ 对每一页循环create_slide选择版式→write_slide按返回的 Schema 填写内容→generate_slide→ 最后save_generated_slides(su7.pptx)。生成的效果类似上图所示的深色主题数据页。几个使用建议模板怎么选仓库内置 6 套模板位于 pptagent/templates/包括default通用深绿主题、beamer学术报告风、thu、ucas、hit、cip高校/学术机构风格。让 AI 先调用list_templates阅读每套模板的英文描述再决定一次只改一处set_template会被 AI 反复调用时清空所有未保存的幻灯片见 mcp_server.py所以选好模板前别急着生成文字长短控制每页文本量参考 pptagent/BESTPRACTICE.md 中length_factor的说明中英文混排时可调参避免溢出。常见问题排查清单现象原因与解决办法启动时报 Unable to connect to the model三个环境变量任一有误先手动curl $PPTAGENT_API_BASE/models验证连通性Claude/Cursor 里看不到 pptagent 工具检查command是否指向 uv 的绝对路径保存后记得重启客户端Windows 下无法运行项目不支持原生 Windows请切换到 WSL生成到一半 PPT 被清空是 AI 重复调用了set_template重新生成即可生成后及时save_generated_slides某页报 Element xxx not foundwrite_slide的 Schema 填写不完整让 AI 按报错信息补齐该元素后重试总结把 PPTAgent 接入 Claude 或 Cursor 只需要三步用 uv 安装并设置PPTAGENT_MODEL/PPTAGENT_API_BASE/PPTAGENT_API_KEY在客户端的 MCP 配置中粘贴上面的 JSON 片段并重启用一句自然语言模板 页数 主题开始生成导出 PPTX。配置细节可对照 pptagent/DOC.md服务端逻辑与 7 个工具定义都在 pptagent/mcp_server.py 中想深度定制例如替换模板或加新工具从这里入手即可。祝你早日让 AI 替你做完每一页 PPT 【免费下载链接】PPTAgent项目地址: https://gitcode.com/icip-cas/PPTAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考