mcp-probe-kit 2.2.0 → 2.3.0

package/README.md

@@ -7,9 +7,9 @@
 
 > 🚀 AI 驱动的完整研发工具集 - 覆盖开发全流程
 
-一个强大的 MCP (Model Context Protocol) 服务器，提供 **39 个实用工具**，覆盖代码质量、开发效率、项目管理、UI/UX 设计全流程，所有工具都支持**结构化输出**。
+一个强大的 MCP (Model Context Protocol) 服务器，提供 **42 个实用工具**，覆盖代码质量、开发效率、项目管理、UI/UX 设计、产品设计全流程，所有工具都支持**结构化输出**。
 
-**🎉 v2.0 特性**：结构化输出、工作流编排、UI/UX Pro Max、需求访谈
+**🎉 v2.3 特性**：产品设计工作流（PRD → 原型 → HTML）、结构化输出、工作流编排、UI/UX Pro Max、需求访谈
 
 **支持所有 MCP 客户端**：Cursor、Claude Desktop、Cline、Continue 等
 
@@ -20,7 +20,7 @@
 **👉 [https://mcp-probe-kit.bytezonex.com](https://mcp-probe-kit.bytezonex.com/)**
 
 - [快速开始](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html) - 5分钟完成安装配置
-- [所有工具](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - 39个工具完整列表
+- [所有工具](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - 42个工具完整列表
 - [最佳实践](https://mcp-probe-kit.bytezonex.com/pages/examples.html) - 完整研发流程实战指南
 - [迁移指南](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - 版本升级指南
 
@@ -28,7 +28,7 @@
 
 ## ✨ 核心特性
 
-### 📦 39 个实用工具
+### 📦 42 个实用工具
 
 - **🔄 工作流编排** (10个) - 一键完成复杂开发流程
 - **🔍 代码分析** (7个) - 代码审查、调试、性能优化
@@ -36,6 +36,7 @@
 - **✨ 生成工具** (7个) - 文档、测试、Mock 数据生成
 - **📋 项目管理** (7个) - 需求分析、工作量估算、项目分析
 - **🎨 UI/UX 工具** (6个) - 设计系统、组件生成、设计稿转代码
+- **🚀 产品设计** (3个) - PRD、原型设计、完整产品工作流
 - **🔧 其他工具** (7个) - 代码修复、格式转换、依赖检查
 
 ### 🎯 结构化输出
@@ -51,6 +52,20 @@
 - `start_ui` - UI 开发（设计系统 → 组件 → 代码）
 - 更多...
 
+### 🚀 产品设计工作流
+
+3 个产品设计工具，从需求到可交互原型：
+- `gen_prd` - 生成产品需求文档（PRD）
+- `gen_prototype` - 生成原型设计文档
+- `start_product` - 完整产品设计流程（PRD → 原型 → 设计系统 → HTML 原型）
+
+**工作流程：**
+1. **需求分析** - 生成标准 PRD 文档（产品概述、功能需求、页面清单）
+2. **原型设计** - 为每个页面生成详细的原型文档
+3. **设计系统** - 基于产品类型生成设计规范
+4. **HTML 原型** - 生成可直接在浏览器中查看的交互原型
+5. **项目上下文** - 自动更新项目文档
+
 ### 🎨 UI/UX Pro Max
 
 6 个 UI/UX 工具，从设计系统到代码生成：
@@ -180,6 +195,12 @@ start_bugfix
 # 自动完成：问题定位 → 修复方案 → 测试代码
 ```
 
+### 产品设计
+```bash
+start_product "在线教育平台" --product_type=SaaS
+# 自动完成：PRD → 原型设计 → 设计系统 → HTML 原型
+```
+
 ### UI 开发
 ```bash
 start_ui "登录页面" --mode=auto

package/build/index.js

@@ -2,7 +2,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, gensql, resolveConflict, genreadme, analyzeProject, initProjectContext, addFeature, securityScan, fixBug, estimate, genMock, startFeature, startBugfix, startReview, startRelease, startRefactor, startOnboard, startApi, startDoc, startRalph, interview, askUser, uiDesignSystem, initComponentCatalog, uiSearch, syncUiData, renderUi, startUi } from "./tools/index.js";
+import { initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, gensql, resolveConflict, genreadme, analyzeProject, initProjectContext, addFeature, securityScan, fixBug, estimate, genMock, startFeature, startBugfix, startReview, startRelease, startRefactor, startOnboard, startApi, startDoc, startRalph, interview, askUser, uiDesignSystem, initComponentCatalog, uiSearch, syncUiData, renderUi, startUi, genPrd, genPrototype, startProduct } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { filterTools, getToolsetFromEnv } from "./lib/toolset-manager.js";
@@ -111,6 +111,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await renderUi(args);
             case "start_ui":
                 return await startUi(args);
+            // 产品设计工作流
+            case "gen_prd":
+                return await genPrd(args || {});
+            case "gen_prototype":
+                return await genPrototype(args || {});
+            case "start_product":
+                return await startProduct(args || {});
             default:
                 throw new Error(`未知工具: ${name}`);
         }

package/build/schemas/index.d.ts

@@ -810,4 +810,25 @@ export declare const allToolSchemas: ({
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            description: {
+                type: string;
+                description: string;
+            };
+            product_name: {
+                type: string;
+                description: string;
+            };
+            docs_dir: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
 })[];

package/build/schemas/index.js

@@ -10,6 +10,7 @@ import { projectToolSchemas } from "./project-tools.js";
 import { orchestrationToolSchemas } from "./orchestration-tools.js";
 import { interviewToolSchemas } from "./interview-tools.js";
 import { uiUxSchemas } from "./ui-ux-schemas.js";
+import { productDesignSchemas } from "./product-design-schemas.js";
 // 合并所有工具 schemas
 export const allToolSchemas = [
     ...basicToolSchemas,
@@ -21,4 +22,5 @@ export const allToolSchemas = [
     ...orchestrationToolSchemas,
     ...interviewToolSchemas,
     ...uiUxSchemas,
+    ...productDesignSchemas,
 ];

package/build/schemas/product-design-schemas.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Schema definitions for product design workflow tools
+ */
+export declare const genPrdSchema: {
+    type: "object";
+    properties: {
+        description: {
+            type: string;
+            description: string;
+        };
+        product_name: {
+            type: string;
+            description: string;
+        };
+        docs_dir: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+export declare const genPrototypeSchema: {
+    type: "object";
+    properties: {
+        prd_path: {
+            type: string;
+            description: string;
+        };
+        description: {
+            type: string;
+            description: string;
+        };
+        docs_dir: {
+            type: string;
+            description: string;
+        };
+    };
+    required: never[];
+};
+export declare const startProductSchema: {
+    type: "object";
+    properties: {
+        description: {
+            type: string;
+            description: string;
+        };
+        requirements_file: {
+            type: string;
+            description: string;
+        };
+        product_name: {
+            type: string;
+            description: string;
+        };
+        product_type: {
+            type: string;
+            description: string;
+        };
+        skip_design_system: {
+            type: string;
+            description: string;
+        };
+        docs_dir: {
+            type: string;
+            description: string;
+        };
+    };
+    required: never[];
+};
+export declare const productDesignSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            description: {
+                type: string;
+                description: string;
+            };
+            product_name: {
+                type: string;
+                description: string;
+            };
+            docs_dir: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            prd_path: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            docs_dir: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+})[];

package/build/schemas/product-design-schemas.js

@@ -0,0 +1,86 @@
+/**
+ * Schema definitions for product design workflow tools
+ */
+export const genPrdSchema = {
+    type: "object",
+    properties: {
+        description: {
+            type: "string",
+            description: "产品描述或访谈记录。详细描述产品的目标、功能、用户需求等信息。",
+        },
+        product_name: {
+            type: "string",
+            description: "产品名称（可选）。如果不提供，将使用默认名称'新产品'。",
+        },
+        docs_dir: {
+            type: "string",
+            description: "文档输出目录（可选）。默认为 'docs'。PRD 将保存到 {docs_dir}/prd/ 目录下。",
+        },
+    },
+    required: ["description"],
+};
+export const genPrototypeSchema = {
+    type: "object",
+    properties: {
+        prd_path: {
+            type: "string",
+            description: "PRD 文档路径（可选）。如果提供，将从 PRD 中提取页面清单生成原型。",
+        },
+        description: {
+            type: "string",
+            description: "功能描述（可选）。如果没有 PRD，可以直接提供功能描述生成原型。prd_path 和 description 至少提供一个。",
+        },
+        docs_dir: {
+            type: "string",
+            description: "文档输出目录（可选）。默认为 'docs'。原型文档将保存到 {docs_dir}/prototype/ 目录下。",
+        },
+    },
+    required: [],
+};
+export const startProductSchema = {
+    type: "object",
+    properties: {
+        description: {
+            type: "string",
+            description: "产品描述。详细描述产品的目标、功能、用户需求等信息。这是整个工作流的基础输入。如果提供了 requirements_file，此参数可选。",
+        },
+        requirements_file: {
+            type: "string",
+            description: "需求文档文件路径（可选）。如果提供，将读取该文件的完整内容作为产品需求。支持 Markdown、文本等格式。例如：'docs/requirements.md'、'project.md'。",
+        },
+        product_name: {
+            type: "string",
+            description: "产品名称（可选）。如果不提供，将使用默认名称'新产品'。",
+        },
+        product_type: {
+            type: "string",
+            description: "产品类型（可选）。用于生成设计系统，如 'SaaS'、'E-commerce'、'Healthcare' 等。默认为 'SaaS'。",
+        },
+        skip_design_system: {
+            type: "boolean",
+            description: "跳过设计系统生成（可选）。默认为 false。如果设置为 true，将不生成设计系统。",
+        },
+        docs_dir: {
+            type: "string",
+            description: "文档输出目录（可选）。默认为 'docs'。所有文档将保存到此目录下的子目录中。",
+        },
+    },
+    required: [],
+};
+export const productDesignSchemas = [
+    {
+        name: "gen_prd",
+        description: "生成产品需求文档（PRD）。基于产品描述或访谈记录生成标准的 PRD 文档，包含产品概述、功能需求、优先级、非功能性需求和页面清单。",
+        inputSchema: genPrdSchema,
+    },
+    {
+        name: "gen_prototype",
+        description: "生成原型设计文档。基于 PRD 文档或功能描述生成原型设计文档，包含页面结构、交互说明和元素清单。为每个页面生成独立的 Markdown 文档。",
+        inputSchema: genPrototypeSchema,
+    },
+    {
+        name: "start_product",
+        description: "产品设计完整工作流编排。一键完成从需求到 HTML 原型的全流程：生成 PRD → 生成原型文档 → 生成设计系统 → 生成 HTML 可交互原型 → 更新项目上下文。生成的 HTML 原型可以直接在浏览器中查看和演示。",
+        inputSchema: startProductSchema,
+    },
+];

package/build/tools/gen_prd.d.ts

@@ -0,0 +1,12 @@
+/**
+ * gen_prd - 生成产品需求文档（PRD）指导
+ *
+ * 返回 PRD 文档模板和创建指导，由 AI 根据产品描述填充内容并创建文件
+ */
+export declare function genPrd(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/gen_prd.js

@@ -0,0 +1,283 @@
+import { parseArgs, getString } from "../utils/parseArgs.js";
+/**
+ * gen_prd - 生成产品需求文档（PRD）指导
+ *
+ * 返回 PRD 文档模板和创建指导，由 AI 根据产品描述填充内容并创建文件
+ */
+export async function genPrd(args) {
+    try {
+        // 使用智能参数解析
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                description: "",
+                product_name: "新产品",
+                docs_dir: "docs",
+            },
+            primaryField: "description",
+            fieldAliases: {
+                description: ["desc", "需求", "描述"],
+                product_name: ["name", "产品名称"],
+                docs_dir: ["dir", "目录"],
+            },
+        });
+        const description = getString(parsedArgs.description);
+        const productName = getString(parsedArgs.product_name) || "新产品";
+        const docsDir = getString(parsedArgs.docs_dir) || "docs";
+        if (!description) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "❌ 缺少必需参数：description（产品描述或访谈记录）",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const guidanceText = `# 📝 生成产品需求文档（PRD）指导
+
+## 📋 输入信息
+
+- **产品名称**: ${productName}
+- **文档目录**: ${docsDir}
+- **产品描述**: 
+${description}
+
+---
+
+## 🎯 任务说明
+
+请根据上述产品描述，创建一个完整的 PRD 文档。
+
+---
+
+## 📄 PRD 文档模板
+
+请将以下模板保存为 \`${docsDir}/prd/product-requirements.md\`：
+
+\`\`\`markdown
+# 产品需求文档 (PRD) - ${productName}
+
+> 生成时间：${new Date().toLocaleString('zh-CN')}
+> 工具版本：mcp-probe-kit v2.3.0
+
+## 目录
+
+- [1. 产品概述](#1-产品概述)
+- [2. 功能需求](#2-功能需求)
+- [3. 功能优先级](#3-功能优先级)
+- [4. 非功能性需求](#4-非功能性需求)
+- [5. 页面清单](#5-页面清单)
+
+---
+
+## 1. 产品概述
+
+### 1.1 产品愿景
+
+${description}
+
+### 1.2 目标用户
+
+**根据产品描述分析目标用户群体：**
+- 用户群体 1：[请根据产品描述填写]
+- 用户群体 2：[请根据产品描述填写]
+- 用户群体 3：[请根据产品描述填写]
+
+### 1.3 核心价值
+
+**提炼产品的核心价值主张：**
+- 价值点 1：[请根据产品描述填写]
+- 价值点 2：[请根据产品描述填写]
+- 价值点 3：[请根据产品描述填写]
+
+---
+
+## 2. 功能需求
+
+### 2.1 核心功能
+
+**根据产品描述提取核心功能列表：**
+
+1. **功能 1**
+   - 描述：[功能描述]
+   - 用户价值：[为用户带来什么价值]
+
+2. **功能 2**
+   - 描述：[功能描述]
+   - 用户价值：[为用户带来什么价值]
+
+3. **功能 3**
+   - 描述：[功能描述]
+   - 用户价值：[为用户带来什么价值]
+
+### 2.2 用户故事
+
+**生成用户故事：**
+
+- 作为 [角色]，我希望 [功能]，以便 [价值]
+- 作为 [角色]，我希望 [功能]，以便 [价值]
+- 作为 [角色]，我希望 [功能]，以便 [价值]
+
+---
+
+## 3. 功能优先级
+
+### P0（必须有 - Must Have）
+
+**识别核心功能（产品 MVP 必需）：**
+- [ ] 功能 1
+- [ ] 功能 2
+
+### P1（应该有 - Should Have）
+
+**识别重要但非核心的功能：**
+- [ ] 功能 3
+- [ ] 功能 4
+
+### P2（可以有 - Could Have）
+
+**识别锦上添花的功能：**
+- [ ] 功能 5
+- [ ] 功能 6
+
+---
+
+## 4. 非功能性需求
+
+### 4.1 性能要求
+
+**根据产品类型提出性能要求：**
+- 页面加载时间：< 2 秒
+- API 响应时间：< 500ms
+- 并发用户数：[根据产品规模估算]
+
+### 4.2 安全要求
+
+**提出安全要求：**
+- 用户认证：[认证方式]
+- 数据加密：[加密方式]
+- 权限控制：[权限模型]
+
+### 4.3 兼容性要求
+
+**提出兼容性要求：**
+- 浏览器支持：Chrome、Firefox、Safari、Edge（最新两个版本）
+- 移动端支持：iOS 13+、Android 8+
+- 屏幕分辨率：支持响应式设计
+
+---
+
+## 5. 页面清单
+
+**根据功能需求列出所有需要的页面：**
+
+| 页面名称 | 页面路径 | 页面类型 | 说明 |
+|---------|---------|---------|------|
+| 首页 | / | 主页面 | 产品介绍和导航入口 |
+| 登录页 | /login | 认证页面 | 用户登录 |
+| 注册页 | /register | 认证页面 | 用户注册 |
+| 功能页 1 | /feature-1 | 功能页面 | [功能说明] |
+| 功能页 2 | /feature-2 | 功能页面 | [功能说明] |
+
+---
+
+## 附录
+
+### 术语表
+
+- **术语 1**：定义
+- **术语 2**：定义
+
+### 参考资料
+
+- [相关文档或链接]
+
+---
+
+**注意：** 本文档由 AI 辅助生成，请根据实际情况调整和完善内容。
+\`\`\`
+
+---
+
+## ✅ 执行步骤
+
+1. **创建目录**: 确保 \`${docsDir}/prd/\` 目录存在
+2. **创建文件**: 将上述模板保存为 \`${docsDir}/prd/product-requirements.md\`
+3. **填充内容**: 根据产品描述智能填充所有标记为 [请根据产品描述填写] 的部分
+4. **完善细节**: 
+   - 分析目标用户群体
+   - 提炼核心价值主张
+   - 提取核心功能列表
+   - 生成用户故事
+   - 划分功能优先级
+   - 列出所有需要的页面
+
+---
+
+## 📌 填充指南
+
+### 1.2 目标用户
+- 分析产品描述中提到的用户群体
+- 考虑产品的使用场景和目标市场
+- 描述每个用户群体的特征和需求
+
+### 1.3 核心价值
+- 提炼产品解决的核心问题
+- 描述产品为用户带来的主要价值
+- 突出产品的差异化优势
+
+### 2.1 核心功能
+- 从产品描述中提取所有功能点
+- 为每个功能描述其作用和用户价值
+- 确保功能覆盖产品的核心需求
+
+### 2.2 用户故事
+- 使用"作为...我希望...以便..."格式
+- 每个用户故事对应一个具体功能
+- 确保用户故事清晰、可测试
+
+### 3. 功能优先级
+- P0: 产品 MVP 必需的核心功能
+- P1: 重要但非核心的功能
+- P2: 锦上添花的功能
+
+### 5. 页面清单
+- 列出所有需要的页面
+- 包括页面路径、类型和说明
+- 确保页面覆盖所有功能
+
+---
+
+## 🎯 下一步建议
+
+1. 完成 PRD 文档创建后，使用 \`gen_prototype\` 工具生成原型设计文档
+2. 或使用 \`start_product\` 工具执行完整的产品设计工作流
+
+---
+
+💡 **提示**: 这是一个指导文档，AI 需要根据产品描述智能填充所有内容并创建实际的 PRD 文件。
+`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: guidanceText,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 生成 PRD 指导失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/gen_prototype.d.ts

@@ -0,0 +1,12 @@
+/**
+ * gen_prototype - 生成原型设计文档指导
+ *
+ * 返回原型设计文档模板和创建指导，由 AI 根据 PRD 或功能描述填充内容并创建文件
+ */
+export declare function genPrototype(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;