Spec Generator MCP

Evolution MCP 服务器 v2.0

四维（存在性·历史性·关联性·非合理性）× 简洁性 × Figma UI

MCP服务器能够在没有详细指示的情况下自动生成用户真正愿意持续使用的应用程序。

“即使没有详细指示，也能做出出色的应用程序”

______________________________________________________________________

🌟 特点

始终被人们所意识的原则（暗中进行）

注册Claude Code后，需遵守以下原则在水下自动地适用范围：

1. 四维原则

• 实在性因生存和存在而产生的价值
• 历史性时间的积淀
• 关系性与他人的创生性互动
• 非合理性超越逻辑的人的本质

→ 通过至少在最低限度上深入实施，打造让用户想持续使用的应用

2. 简约原则

• 3-1-1规则核心功能1个，必备支持功能最多3个，附加功能最多1个
• 不是增加功能，而是给现有功能融入四维元素

→ 简单却深具魅力的应用

3. Figma的UI（必备条件）

• 现代而专业的设计
• 避免过于简单的Claude式用户界面
• 推荐使用shadcn/ui、Tailwind CSS等

→ 既美观又好用的应用

______________________________________________________________________

🚀 安装设置

1. 克隆仓库

\\\bash（注：\bash\ 是 Bourne-Again Shell 的缩写，是一种广泛使用的 Unix/Linux 命令行解释器） 克隆仓库：\git clone https://github.com/Gaku52/spec-generator-mcp.git\` 进入 spec-generator-mcp 目录 （这个句子本身没有实际意义，可能是一个占位符或示例，因此翻译时也保持其形式不变，但若要解释其存在，可以说）这可能是用于展示或说明某种格式或示例的占位文本。

2. 安装依赖项

\\\bash（注：在中文语境下，这通常表示接下来是一段bash命令或脚本的代码块，但“bash”本身无需翻译） npm install \\\

3. 构建

\\\bash（注：\bash\是Unix/Linux操作系统中的一个命令行解释器，此处直接保留原样，因为“bash”本身无需翻译） npm run build 翻译成中文是：“运行 npm 构建命令” \\\

4. 注册Claude Code

claude_desktop_config.json进行编辑：

Windows： \%APPDATA%\\Claude\\claude_desktop_config.json\ 翻译成中文是：“应用程序数据目录下的 Claude 文件夹中的 claude_desktop_config.json 配置文件”

macOS： \~/Library/Application Support/Claude/claude_desktop_config.json\ 翻译成中文是：\用户库/应用程序支持/Claude/claude_desktop_config.json\。不过，这里的“用户库”是“~/Library”的一种更通俗的解释，实际上在中文技术文档或说明中，我们通常会直接使用“~/Library”来表示这个路径，因为它已经是一个被广泛接受的表示方式。所以，更简洁的翻译可以是：“~/Library/Application Support/Claude/claude_desktop_config.json（路径）”。但考虑到直接翻译的需求，上述“用户库/应用程序支持/Claude/claude_desktop_config.json”也是可以接受的

设置内容：

\\\json { "mcpServers": { "进化"：{ "命令": "node",， "args": \[ "/绝对路径/to/spec-generator-mcp/dist/index.js" \] } } } \\\

※请根据实际环境更改密码

Windows示例： \\\json { "mcpServers": { "进化"：{ "command": "node", （翻译为）"命令": "node",， "args": \[ "C:\\\\Users\\\\YourName\\\\spec-generator-mcp\\\\dist\\\\index.js" 翻译成中文可以是：“C盘\\\\用户\\\\你的用户名\\\\spec-generator-mcp\\\\dist\\\\index.js”。不过，在实际中文语境中，我们通常不会直接翻译路径中的斜杠和盘符，而是保持原样，因为这些是文件系统路径的一部分，直接翻译并不改变其含义。所以，更常见的表达方式就是直接写出这个路径，即：“C:\\\\Users\\\\YourName\\\\spec-generator-mcp\\\\dist\\\\index.js”，或者在中文文档中可能会稍作调整以适应阅读习惯，但核心路径信息保持不变 \] } } } \\\

5. 重启Claude Code

为反映设置，需执行Claude Code完全重启请（帮我）。

______________________________________________________________________

💡 使用方法

模式1：最简单（推荐）

即便用户没有给出详细指示，也能自动生成出色的应用。

\\\` 你：“做个待办事项应用”

克劳德代码： → 自动分析四维数据 遵循简约原则 使用Figma的UI进行设计 → 开始实施

\[结果\]

• 核心功能：添加/完成任务（简单）
• 历史性：大幅显示持续天数
• 不合理性：达成100个后有烟花表演
• Figma的UI：使用shadcn/ui

\\\`

模式2：生成需求定义书

（该句为开始标记，无实际翻译内容，若需翻译后续内容，请提供具体文本） 你：“帮我写一份照片共享应用的需求定义书。”

克劳德·科德（Claude Code，此处为假设的翻译，实际人名翻译可能因具体语境而异） 执行generate_requirement_spec工具 生成融入四维与简洁性的需求定义书 → 也包含Figma的UI要素 \\\`

模式3：确认资源

如需确认原则详情：

\\\` 你：“告诉我四次元的原则。”

克劳德密码： 加载 evolution://principles/four-dimensions → 显示详细说明 \\\`

______________________________________________________________________

📚 可用资源

MCP服务器提供的资源（可随时访问）：

______________________________________________________________________

🛠️ 提供的工具

v2.0工具

| 生成功能规格说明书 | 同上 |

计划在v2.1中添加 | 工具 | 说明 | |--------|------| discover_app_ideas | | 由AI主导提出应用创意 | initialize_project |

______________________________________________________________________

项目初始化（创建四维DNA）

🎯 实际体验

以往（传统方法） （此句为程序或指令开头，无实际含义，可翻译为）"（程序或指令开始）"

你：“做个待办事项应用”

克劳德：“需要什么功能？” 你：“添加任务、编辑、删除、分类、设置优先级、

期限管理、提醒功能、统计功能、共享功能..」

克劳德：“我们要开发一个复杂待办事项应用” \[结果\] ❌ 功能过多，不好用 ❌ 用户界面粗糙 ❌ 没人会一直用

\\\`

之后（Evolution MCP v2.0） （此句为占位符或用于特定上下文中的标记，无实际翻译意义，若需结合具体语境翻译，需提供更多信息）

你：“做个待办事项应用” （自动）克劳德代码： ✅ 分析四维 → 重视历史性 ✅ 简约原则 → 功能精简为三项

✅ Figma UI → shadcn/ui + Tailwind（将Figma界面设计转换为shadcn/ui库结合Tailwind CSS实现） \[结果\] ✅ 简单却让人想持续下去 ✅ 精美的用户界面

✅ 人们持续使用的应用程序

• 功能：
• 任务添加·完成（核心）
• 任务编辑·删除（支持）
• 持续天数显示（历史性）
• 达成100个即庆贺（不合理）

现代UI（Figma风格）

______________________________________________________________________

\\\`

🔍 机制

资源功能 MCP服务器将原则作为资源提供→ Claude Code一直在暗中 可参考

→ 自动应用

即时响应功能 在希望明确适用原则时使用

→ 更为确切的适用

自然融合 用户无需在意原则 → Claude Code自动做出最佳判断

______________________________________________________________________

实现“无需详细指示也能开发出色应用”

成功方程式 （这个句子本身是一个代码块的开始，没有实际内容，所以翻译时需要根据上下文或意图来给出一个合适的中文表述。如果仅作为示例或说明，可以翻译为：）这是一个代码块的开始。

爆红的原因 = 简约 × 四维魅力 最低要求：深入实施一维化 理想：满足3-4D + 简洁 + Figma UI

（这个句子本身是一个程序代码或指令的开始标记，没有实际的中文含义，但如果要解释其用途，可以翻译为）"（这是程序代码或指令的开始标记）"

成功案例分析（四维评分）

| Notion | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ | 成功（非爆发性） | 教训：

______________________________________________________________________

四维+简洁=爆炸式成功

路线图

• v2.0（当前）✅
• \[x\] 将四维原则资源化
• \[x\] 简洁性原则
• \[x\] Figma的UI建议（必备条件）
• \[x\] 资源/提示功能

\[x\] 现有工具的v2.0兼容性

• v2.1（近日） discover_app_ideas \[ \]
• \- 以AI为主导的想法生成 initialize_project \[ \]
• \- 项目初始化

\[ \] 知识积累机制的基础

• v3.0（未来）
• \[ \] 从过往项目中自动学习
• \[ \] 成功案例分析

______________________________________________________________________

\[ \] 完全支持开发生命周期

📂 项目结构 （注：此句“\\\`”本身无实际意义，可能是用于标记或分隔的符号，在中文中可不直接翻译，但若需说明其存在，可表述为“此句为标记或分隔符号，无实际翻译内容”。） spec-generator-mcp/（可翻译为）规格生成器-MCP/（或根据上下文具体含义调整，如“MCP规格生成工具/”等） ├── src/（源代码目录） │ ├── index.ts # MCP服务器（v2.0） │ ├── resources/ # 原则（始终可参考） │ │ ├── fourDimensions.ts # 四维原则 │ │ ├── simplicityPrinciples.ts # 简约原则 │ │ └── designPrinciples.ts # Figma的UI设计原则文件 │ ├── tools/ # 工具 │ │ ├── requirementSpec.ts # 需求规格说明书（支持v2） │ │ └── functionalSpec.ts # 功能规格书 │ └── templates/ # 模板 │ ├── requirement.ts # v1.0 │ ├── requirementV2.ts # v2.0（支持四维） │ └── functional.ts（翻译为：│ └── 功能性文件.ts） ├── dist/ # 构建输出 ├── package.json # evolution-mcp v2.0.0（版本号：2.0.0的evolution-mcp） └── README.md（中文可译为：“└── 说明文件.md” 或 “└── 项目说明文档.md”，但通常直接保留原文件名形式，因为文件名在中文语境下也常直接使用）

______________________________________________________________________

（此句为程序或指令开始的标记，无实际翻译内容，若需结合上下文翻译，可译为“以下是...”或“接下来是...”等，具体根据上下文确定）

🔧 开发

开发模式 \\\bash（注：此为代码块开始的标记，通常不直接翻译，但在此上下文中可理解为“以下为bash命令/代码”） \npm run dev\` 翻译成中文是：“运行 npm 的 dev 脚本”

\\\`

监控TypeScript文件的更改，并自动重新构建。

定制src/resources/资源文件（ 通过编辑（该部分），可自定义原则。

______________________________________________________________________

不过，最好不要改变四次元与简洁的本质。

❓ 故障排除

1. MCP服务器未被识别

确认构建是否成功 \\\`bash（注：这行代码本身是表示要输入Bash命令的提示符，在中文中通常不直接翻译，但为保持格式一致，可理解为“以下是Bash命令”或保持原样不译） npm run build 翻译成中文是：“运行 npm 构建命令”

1. claude_desktop_config.json \\\`

1. 确认路径是否正确Claude Code

完全重启

1. 资源未加载
2. 确认MCP服务器是否已启动
3. 使用Claude Code Developer Tools查看日志

服务器重启

1. 构建错误
2. 确认Node.js版本（推荐v18+）

重新安装依赖关系 \\\`bash（注：此行通常表示接下来是一段 Bash 脚本或命令，直接翻译为中文即“以下是 Bash 命令或脚本”） 删除 node_modules 目录和 package-lock.json 文件 npm install

______________________________________________________________________

\\\`

📝 许可证

______________________________________________________________________

麻省理工学院许可证

🙏 贡献（也可译为“助力”或“贡献”）该项目让人真正想持续使用的应用

是为了制作（某物）而进行的实验。

欢迎反馈和改进建议！

______________________________________________________________________

问题：https://github.com/Gaku52/spec-generator-mcp/issues

• 🌐 参考链接
• MCP 文档
• 克劳德·科德
• shadcn/ui（可译为“Shadcn UI”，通常指代一个基于Tailwind CSS的UI组件库）

______________________________________________________________________

Tailwind CSS

Evolution MCP v2.0——在水面下打造卓越应用