mcp-apps-office-kit

基于 MCP Apps 扩展机制 的 Office-Kit：让 LLM Desktop（Claude Desktop / 等）通过画布核心 (Canvas Core) 生成 PPT / HTML / FlowChart 等富媒体内容。

核心理念：HTML 即真相层 · Tailwind + shadcn 即设计语言 · 画布核心即底座 · App 即领域封装。

---

📖 文档

• plan.md · 项目总纲（分层架构 / MVP / 迭代计划 / ADR 索引）
• docs/adr/ · 架构决策记录（ADR-0001 ~ 0005）
• docs/iterations/ · 周迭代细节

🚀 快速开始（W1 阶段）

pnpm install
pnpm dev                 # 启动 server.ts（http://localhost:3456）
pnpm build               # 产出 dist/mcp-ppt-app.html
pnpm test                # 跑 sanitize / contract 单测

W1 Smoke：

# 验证 sanitize + contract 通路
curl -X POST http://localhost:3456/debug/generate_ppt \
  -H "Content-Type: application/json" \
  -d '{"topic":"AI 的未来"}'

📂 目录结构

详见 plan.md §0.2。

🛠 当前阶段

W1 · 工程骨架 & MCP 通路 & 安全底座（v0.0.1）

• ✅ Vite 多入口 + TS strict + ESLint/Prettier
• ✅ src/core/ 三件套（AppDefinition / Registry / Express）
• ✅ src/shared/html/sanitize.ts（DOMPurify + 白名单）
• ✅ src/shared/html/contract.ts（稳定 ID 补发 · ADR-0004）
• ✅ 空壳 PPT App
• ⏳ Day 2：接入 MCP SDK Streamable HTTP
• ⏳ Day 5：ADR 决策日 + Demo

📜 License

Private / Internal