把 2300032166/auto-ppt-agent-mcp 克隆下来后，最容易卡住的不是“会不会生成 PPT”，而是根目录和运行入口容易看错：仓库根目录放着 README 和演示材料，真正的 Python 项目在 auto-ppt-agent/ 里面。想确认这个 skill 接入 MCP 后到底有没有跑通，先记住一个顺序：先在 auto-ppt-agent/ 里跑通 CLI，再去接 mcp_servers/ppt_server.py，看到 output/ 里出现新的 .pptx 才算有结果。

2300032166/auto-ppt-agent-mcp skill 的核心不是把一段话直接塞进模板，而是用一个代理流程来拆题、联网搜索事实数据，再把 PowerPoint 渲染交给独立的 MCP server。新手不要一上来就把 CLI、MCP Inspector 和网页模式混在一起排错；入口分清，依赖、模型下载和输出文件才好判断。

先把入口分清，MCP 才好排错

README 写了三种运行方式：推荐的端到端 CLI、直接接 MCP server、以及本地网页模式。真正用于确认环境是否正常的第一步，建议走 CLI，因为它会自动串起本地 LLM、主题引擎、Web Search MCP 工具和 PPT Builder MCP 工具。CLI 跑不通时，先不要急着怀疑 MCP 客户端配置，往往是依赖没装在正确目录、首次模型下载没完成，或者联网搜索不可用。

目录也要看准。当前仓库的代码树里，requirements.txt、run_agent.py、mcp_servers/、themes/、config/ 和 output/ 都在 auto-ppt-agent/ 下面。MCP server 文件在 auto-ppt-agent/mcp_servers/，其中有 ppt_server.py 和 web_search_server.py。如果你在仓库根目录直接执行 pip install -r requirements.txt 找不到文件，问题不是项目坏了，而是目录站错了。

第一次试跑，先让 CLI 生成一个小 PPTX

本机先准备 Python 3.10+，再进入实际项目目录安装依赖。第一次启动会下载 google/flan-t5-base，README 里写到大约需要 1GB 磁盘空间和可用网络；这一步慢，不代表 MCP 已经失败。

git clone https://github.com/2300032166/auto-ppt-agent-mcp.git
cd auto-ppt-agent-mcp/auto-ppt-agent
pip install -r requirements.txt

试跑不要先用复杂题目，直接用 README 或演示命令里的小主题更好判断。比如：

python run_agent.py "Artificial Intelligence in Modern World" --slides 5 --output ai_general.pptx

如果想指定风格，可以换成 README 里列出的 professional、dark、academic、creative、minimal。比如演示文件里还有医疗、量子计算、数字营销、机器学习等主题命令。试跑阶段只要主题短、页数少、输出文件名明确，就能更快判断环境问题。

MCP 接入只看两个成功信号

CLI 能生成后，再测试 MCP server 会更稳。README 的 MCP Inspector 示例是：

npx @modelcontextprotocol/inspector python ppt_server.py

如果你在 auto-ppt-agent/ 目录里操作，路径更稳的写法是：

npx @modelcontextprotocol/inspector python mcp_servers/ppt_server.py

接入 MCP 客户端时，也按同一个思路配置：工作目录指向 auto-ppt-agent/，命令用 python，参数指向 mcp_servers/ppt_server.py。不要把 web_search_server.py 和 ppt_server.py 混成一个入口；前者负责搜索工具，后者才是 PPT Builder 这条线的直接测试对象。

跑通时，控制台会出现一串很具体的动作：Planning slides... 表示 T5 在规划页面结构，set_theme()... 表示主题识别开始，mcp search_web(...) 表示通过 DuckDuckGo 取事实数据，mcp write_text(...) 表示内容写入页面，mcp save_presentation(...) 表示开始保存。只看到前两步却没有 save_presentation，通常还不能算成功。

真正的验收点是 output/。README 明确写到最终 .pptx 会保存在这个目录，项目结构也把它标成生成文件所在位置。打开新文件后，再看主题是否生效、页数是否接近命令里的 --slides、内容是否来自可搜索事实，而不是空白占位。把这两个信号守住，2300032166/auto-ppt-agent-mcp skill 的 MCP 接入排错就会清楚很多：先确认本地代理能生成，再确认 MCP server 能被客户端连上，再看 output/ 是否真的产出 PPTX。