@deppon/deppon-prd-mcp

私有化 PRD 生成 + 交互原型 MCP 服务，基于仓库内 deppon-prd-generator skill 模板。

功能

1. Web 控制台（http://127.0.0.1:3847）：填写 PRD 要素（标题、背景、筛选字段、列表列等）→ 生成标准化 prd.md
2. 原型生成：根据同一套配置生成 Tailwind 高保真 prototype.html（含 PRD § 标注弹框）
3. 在线动态调整（类墨刀）：设计模式 ?design=1 下可 拖拽 区块/筛选项/列表列/工具栏按钮排序，改文案，移除不合适项，保存后写入 project.config.json 并同步 PRD
4. MCP 工具：供 Cursor Agent 调用 generate_prd、generate_prototype、open_prd_studio 等

安装（消费方）

npm install -g @deppon/deppon-prd-mcp
# 或无需全局安装，直接在 MCP 配置里用 npx

快速开始

# 仅 Web 控制台
npx @deppon/deppon-prd-mcp --web-only

# MCP + Web（供 AI 工具 stdio 调用时自动拉起 Web）
npx @deppon/deppon-prd-mcp

浏览器打开 Web 控制台：http://127.0.0.1:3847

设计模式（拖拽调整布局）

1. Web Studio → ③ 原型编辑 → 点 🎨 设计模式（拖拽）
2. 或直接在原型 URL 加 ?design=1
3. 拖拽 ⠿ 手柄调整：筛选区/列表区块顺序、筛选项、表头列、工具栏按钮
4. 点击 保存布局 → 写入 project.config.json，并重新生成 prd.md + prototype.html

Cursor / Claude Desktop MCP 配置

{
    "mcpServers": {
        "deppon-prd": {
            "command": "npx",
            "args": ["-y", "@deppon/deppon-prd-mcp@latest"],
            "env": {
                "DEPPON_PRD_WORKSPACE": "/绝对路径/到你的项目根目录",
                "DEPPON_PRD_HTTP_PORT": "3847"
            }
        }
    }
}

monorepo 内开发时可改用本地路径："command": "node", "args": ["packages/deppon-prd-mcp/dist/cli.js"]

发布（维护方）

cd packages/deppon-prd-mcp
npm run build
npm run publish:auto          # npm @deppon/deppon-prd-mcp
npm run publish:registry      # MCP 官方 Registry（需先 mcp-publisher login github）

MCP 官方 Registry

1. 安装 CLI（Homebrew 没有 mcp-publisher formula，须从 GitHub Releases 下载）：

# Apple Silicon Mac
curl -fL "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_darwin_arm64.tar.gz" \
  | tar xz mcp-publisher
sudo mv mcp-publisher /usr/local/bin/
# 若无 sudo，可放到 ~/.local/bin 并确保在 PATH 中

mcp-publisher --help

2. 登录：mcp-publisher login github（须用 GitHub 账号 chriswong1103）
3. 发布：cd packages/deppon-prd-mcp && mcp-publisher publish

Registry 名称：io.github.chriswong1103/deppon-prd-mcp（与 package.json 的 mcpName 一致，须用 GitHub 账号 chriswong1103 登录）

输出目录

src/prototypes/<slug>/
├── project.config.json   # 结构化配置（可 round-trip 编辑）
├── prd.md                  # 标准化 PRD（默认 DP-IT 标题）
└── prototype.html          # 可交互原型

MCP 工具

| 工具 | 说明 | | ----------------------- | ------------------------------------------------------------- | | generate_prd | 从 pageName 等要素生成 PRD 并落盘 | | generate_prototype | 从已有 slug 重新生成 prototype.html | | list_prd_projects | 列出已生成项目 | | get_prd_project | 读取项目配置与 PRD 摘要 | | open_prd_studio | 返回 Web 控制台 URL | | export_canvas_handoff | 导出 Penpot/Reframe/tldraw handoff（含 wireframe.tldr） |

环境变量

| 变量 | 默认 | 说明 | | ---------------------- | --------------- | -------------- | | DEPPON_PRD_WORKSPACE | process.cwd() | 仓库根目录 | | DEPPON_PRD_HTTP_PORT | 3847 | Web 控制台端口 | | DEPPON_PRD_HTTP_HOST | 127.0.0.1 | 绑定地址 |

文档

| 文档 | 说明 | | ---------------------------------------------------------------- | --------------------------------------------------- | | Cursor + MCP 使用指南 | Agent 生成 PRD/原型、设计模式、常见问题 | | Penpot/Reframe 画布联调 | PRD 走 deppon-prd，原型交 Penpot/Reframe MCP | | 墨刀分析 & 演进路线图 | 墨刀 Proto2 技术反推、scene.json 规划、Phase 1 ～ 3 |