# mcp-apps-office-kit

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

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

---

## 📖 文档

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

## 🚀 快速开始（W1 阶段）

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

**W1 Smoke**：

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

## 📂 目录结构

详见 [`plan.md §0.2`](./plan.md)。

## 🛠 当前阶段

**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