🚀 MCPA2APPT / MultiAgentPPT

集成 A2A + MCP + ADK 架構的智能化演示文稿生成系統，支持多智能體協作與流式并發，實時生成高質量 PPT 內容。

---

🧠 項目簡介

MultiAgentPPT（又名 MCPA2APPT）采用 A2A（Ask-to-Answer）、MCP（Multi-agent Control Protocol）和 ADK（Agent Development Kit）三大核心模塊，構建從用戶輸入主題到完整演示文稿輸出的自動化流水線：

1. 大綱生成 Agent
   根據用戶需求，生成初步內容大綱。

2. Topic 拆分 Agent
   將大綱拆解為若干子主題。

3. Research Agent（并行）
   多個智能體并行對各主題展開檢索與調研。

4. Summary Agent
   匯總各 Research Agent 結果，生成幻燈片內容，采用流式并發返回至前端。

源碼（Fork）：https://github.com/MaoTouHU/MCPA2APPT

---

? 系統優勢

• 多Agent協作：并行化處理，顯著提升生成效率與內容質量。
• 實時流式返回：大綱和幻燈片內容逐步展現，用戶體驗更流暢。
• 高質量輸出：集成外部檢索，結合智能體協作深度挖掘信息。
• 模塊化可擴展：可按需添加智能體或功能插件。

---

📸 界面演示

1. 主題輸入

用戶在前端輸入希望生成的 PPT 主題：

---

2. 大綱流式生成

系統實時返回大綱結構：

---

3. 完整大綱展示

用戶確認并微調最終大綱：

---

4. PPT 內容流式生成

基于確認的大綱，系統并發生成各頁內容：

---

📊 并發多Agent協作流程

---

🗂? 項目結構

MultiAgentPPT/
├── backend/              
│   ├── simpleOutline/    # 簡化大綱生成（無外部依賴）
│   ├── simplePPT/        # 簡化 PPT 生成（無并發/檢索）
│   ├── slide_outline/    # 高質量大綱生成（含檢索）
│   └── slide_agent/      # 多Agent 并發 PPT 主服務
└── frontend/             # Next.js 前端界面

---

?? 快速開始

🐍 后端環境配置

# 1. 創建并激活 Conda 虛擬環境
conda create --name multiagent python=3.12
conda activate multiagent# 2. 安裝依賴
cd backend
pip install -r requirements.txt# 3. 配置環境變量
for module in simpleOutline simplePPT slide_outline slide_agent; docd backend/$module && cp env_template .env && cd ../../
done

---

🚀 啟動后端服務

模塊	功能	默認端口	啟動命令
simpleOutline	簡化大綱生成	10001	python main_api.py
simplePPT	簡化 PPT 生成	10011	python main_api.py
slide_outline	高質量大綱（含檢索）	10001*	python main_api.py
slide_agent	多Agent 并發生成完整 PPT	10011*	python main_api.py

* 啟動前請先關閉對應簡化服務。

---

🛢? 前端數據庫設置

1. 啟動 PostgreSQL：

   docker run --name postgresdb -p 5432:5432 \-e POSTGRES_USER=postgres \-e POSTGRES_PASSWORD=welcome -d postgres
   

2. 安裝依賴并推送 Prisma 模型：

   pnpm install
   pnpm db:push
   

3. 如無默認用戶，請手動插入一條：
   frontend/insert_one_user.sql

4. 更新 .env：

   DATABASE_URL="postgresql://postgres:welcome@localhost:5432/presentation_ai"
   A2A_AGENT_OUTLINE_URL="http://localhost:10001"
   A2A_AGENT_SLIDES_URL="http://localhost:10011"
   

---

🌐 前端安裝與運行

cd frontend
npm install
cp env_template .env
npm run dev

瀏覽器訪問：http://localhost:3000

---

🧪 示例數據說明

系統內置演示主題：“電動汽車發展概述”。
如需自定義主題，請接入對應 Agent 并配置數據源。

---

📎 參考來源

• 前端項目參考：allweonedev/presentation-ai

結語

非常感謝所有開源社區的無私奉獻和貢獻，正是因為有了 A2A、MCP、ADK 等核心架構的開放與共享，MultiAgentPPT 才得以順利構建并不斷迭代。該系統通過多智能體協作與流式并發機制，實現了從主題輸入到高質量 PPT 輸出的全流程自動化，為用戶帶來了更高效、精準、流暢的演示文稿創作體驗。再次感謝所有開發者、文檔維護者和測試者的辛勤付出，讓這一智能化演示工具得以惠及更多人。期待未來更多優秀的開源項目，共同推動技術與創意的無限可能！