mcp-apps-office-kit

Office-Kit based on the MCP Apps extension mechanism: Allows LLM Desktop (Claude Desktop / etc.) to generate rich media content such as PPT / HTML / FlowChart via Canvas Core.

Core Philosophy: HTML is the truth layer · Tailwind + shadcn is the design language · Canvas Core is the foundation · App is the domain encapsulation.

📖 Documentation

• plan.md · Project Overview (Layered Architecture / MVP / Iteration Plan / ADR Index)

• docs/adr/ · Architecture Decision Records (ADR-0001 ~ 0005)

• docs/iterations/ · Weekly Iteration Details

Related MCP server: Photo AI Studio MCP Server

🚀 Quick Start (W1 Phase)

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 的未来"}'

📂 Directory Structure

See plan.md §0.2 for details.

🛠 Current Phase

W1 · Engineering Skeleton & MCP Path & Security Foundation (v0.0.1)

• ✅ Vite Multi-entry + TS strict + ESLint/Prettier

• ✅ src/core/ Trio (AppDefinition / Registry / Express)

• ✅ src/shared/html/sanitize.ts (DOMPurify + Whitelist)

• ✅ src/shared/html/contract.ts (Stable ID Reissue · ADR-0004)

• ✅ Empty Shell PPT App

• ⏳ Day 2: Integrate MCP SDK Streamable HTTP

• ⏳ Day 5: ADR Decision Day + Demo

📜 License

Private / Internal