App Creator MCP

AppCoreator MCP v2.1

完整的AI软件工厂，集成NotebookLM+A2UI

AppCoreator（前身为AppCoreator）是一个人工智能软件工厂，可以根据想法或现有文档自动创建生产就绪的项目。它是一个MCP（模型上下文协议）服务器，与Claude集成，提供完整的项目生成和管理工作流。

🚀 v2.1的新增功能

NotebookLM集成📚

• 基于文档的项目：使用NotebookLM中的现有文档作为基础
• 引用支持的规范：每一项索赔都可以追溯到源文件
• 混合人工智能研究：将笔记本内容与人工智能研究相结合，以弥补差距
• 零幻觉：以实际文件为依据

谷歌A2UI集成🎨

• 人工智能生成的用户界面：真正的工作组件，而不仅仅是提示
• 声明性和安全性：不执行任意代码
• 框架不可知：React、Vue、Angular、原生支持
• 流媒体用户界面：增量组件生成

特性

1.双模项目创建

• 标准模式：AI根据需求从头开始生成
• 文档模式：使用NotebookLM进行基于文档的生成
• 支持多种项目类型：web、API、CLI、桌面、移动、库
• 配置适当的文件夹结构和样板代码

2.NotebookLM集成（新）

• 从NotebookLM笔记本中获取文档
• 带有源代码引用的引用支持规范
• 混合方法：笔记本LM内容+人工智能研究差距
• 覆盖率报告：显示文档与人工智能补充的百分比
• 零幻觉：每一个说法都有来源

3.A2UI驱动前端（新）

• 使用谷歌A2UI标准生成真实UI代码
• 框架无关：React、Vue、Angular、原生
• 安全第一：声明性JSON，而不是可执行代码
• 完整实现：组件、路由、API绑定
• 与Google Stitch兼容的无代码替代提示

4.完整的规格套件生成

• 宪法：项目愿景、原则、制约因素
• 规格：功能需求、数据模型、API
• 技术方案：架构、安全、测试策略
• 任务分解：具有依赖关系和估计的粒度任务

5.自动刷新系统（关键）

• 防止在长时间的开发会话中丢失上下文
• 每20-25个任务自动保存一次项目状态
• 为无缝恢复工作生成继续提示
• POML（项目编排标记语言）模板
• 在多个会话中保持完整的上下文

6.测试和质量保证

• API测试：邮差收藏+Newman CLI命令
• BDD测试：黄瓜/小黄瓜人类可读测试
• 多环境：开发、暂存、生产配置

安装

1. 克隆或下载此存储库
2. 安装依赖项：

npm install

1. 构建项目：

npm run build

用法

📚 全面使用指南

名称：REHBERI.md 一定要读档案！

内容 ：

• ✅ NotebookLM有/没有场景的提示符模板
• ✅ 按项目类型的示例（web，api，mobile，cli，desktop，library）
• ✅ 最佳实践和不应该做的事情
• ✅ 现实世界的例子
• ✅ 故障排除指南
• ✅ 高级使用

以开发模式运行

npm run dev

在生产中运行

npm start

建筑

npm run build

MCP工具

AppCoreator提供了13个功能强大的工具，这些工具被组织成工作流程：

🤖 智能工作流（新增-推荐！）

创建项目最简单的方法——让人工智能处理所有技术决策！

analyze_project_requirements

第一步： 分析您的需求并生成AI驱动的建议。

特征：

• 项目规模自动检测（中小型/大型/企业）
• 优雅的NotebookLM回退（使用或不使用）
• AI推荐：数据库、架构、身份验证、前端
• 每项建议都包括详细的理由和替代方案
• 单一审批点-无需技术知识！

参数：

• project_name （字符串，必填）：项目名称
• project_type （字符串，必填）：web、api、cli、桌面、移动、库
• description （string，必填）：项目描述
• features （数组，必填）：功能列表
• notebook_name （字符串，可选）：用于文档的NotebookLM笔记本
• expected_users （数字，可选）：预期并发用户
• data_volume （字符串，可选）：小、中、大、大
• branches （数组，可选）：地理分支/位置

例子：

{
  "project_name": "real-estate-tracker",
  "project_type": "web",
  "description": "Real estate property tracking system",
  "features": ["property-listing", "agent-management", "client-portal"],
  "notebook_name": "Taşınmaz Takip Dokümanları",
  "expected_users": 100,
  "data_volume": "medium"
}

create_project_from_analysis

第二步： 在批准AI建议后创建完整的项目。

生成：

• 完整的规格套件（组成、规格、技术计划、任务）
• 具有推荐架构的后端结构
• API测试（Postman+Newman）
• A2UI驱动的前端
• BDD/黄瓜测试
• POML上下文保存

参数：

• project_name （字符串，必填）：分析中的项目名称
• approved （boolean，必填）：true继续

例子：

{
  "project_name": "real-estate-tracker",
  "approved": true
}

______________________________________________________________________

📋 标准工作流程（高级用户）

对于希望对工作流有更多控制权的用户：

1. create_project

从头开始创建一个完整的项目。

参数：

• name （字符串，必填）：项目名称
• type （string，必填）：项目类型（web、api、cli、桌面、移动、库）
• tech_stack （string，必填）：技术栈
• description （string，必填）：项目描述
• features （数组，可选）：要实现的功能列表

例子：

{
  "name": "my-awesome-app",
  "type": "web",
  "tech_stack": "react-typescript",
  "description": "A modern web application",
  "features": ["user-auth", "dashboard", "api-integration"]
}

2. get_project_status

获取项目的当前状态和进度。

参数：

• project_name （string，必填）：项目名称

退货：

• 当前进度
• 已完成的任务
• 下一步
• 进度百分比

3. generate_poml

生成或更新POML模板。

参数：

• project_name （string，必填）：项目名称
• update_mode （布尔值，可选）：更新现有或创建新

输出： 创建/更新 PROJECT.poml 包含当前项目状态的文件。

4. auto_refresh

保存状态并生成继续提示，以防止上下文丢失。

参数：

• project_name （string，必填）：项目名称

关键特性：

• 将完整的项目状态保存到 .appcreator/state.json
• 生成连续提示以实现无缝恢复
• 在达到上下文限制之前调用此命令
• 对于长期项目至关重要

5. add_feature

为现有项目添加新功能。

参数：

• project_name （string，必填）：项目名称
• feature_name （字符串，必填）：功能描述
• implementation_notes （字符串，可选）：其他详细信息

使用Claude Desktop进行配置

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "appcreator": {
      "command": "node",
      "args": [
        "C:\\Users\\serha\\OneDrive\\Desktop\\AppCreator-MCP\\build\\index.js"
      ]
    }
  }
}

或用于开发：

{
  "mcpServers": {
    "appcreator": {
      "command": "npx",
      "args": [
        "tsx",
        "C:\\Users\\serha\\OneDrive\\Desktop\\AppCreator-MCP\\src\\index.ts"
      ]
    }
  }
}

项目结构

AppCreator-MCP/
├── src/
│   └── index.ts          # Main MCP server implementation
├── build/                # Compiled TypeScript output
├── package.json          # Project dependencies
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

POML（项目编排标记语言）

AppCreator创建的每个项目都包括 PROJECT.poml 文件用作：

• 项目清单：项目状态的单一真实来源
• 进度跟踪器：实时进度和任务完成
• 上下文保管器：跨会话维护项目上下文
• 人类可读：易于理解和手动编辑

POML示例：

[project]
name = "my-app"
type = "web"
tech_stack = "react-typescript"
status = "active"

[progress]
total_tasks = 20
completed_tasks = 8
current_phase = "development"
progress_percentage = 40.00%

[features]
feature_1 = "user-auth"
feature_2 = "dashboard"

[next_steps]
step_1 = "Implement core features"
step_2 = "Write tests"

工作流示例

🤖 智能工作流程（最简单！）

非常适合： 希望人工智能处理技术决策的用户

1. 分析项目：

Call: analyze_project_requirements
→ AI detects scale automatically
→ Generates recommendations with rationale
→ You review summary
→ Single approval needed

1. 创建项目：

Call: create_project_from_analysis (approved: true)
→ Full project generated with AI recommendations
→ Backend + Frontend + Tests + Docs
→ Ready to code!

总计： 2次工具调用，1次批准✨

______________________________________________________________________

📋 标准工作流程（更多控制）

非常适合： 想要精细控制的用户

1. 创建项目：

Use create_project tool with your idea
→ AppCreator generates complete structure
→ POML template created
→ Ready to start coding

1. 跟踪进度：

Use get_project_status
→ See current progress
→ View next steps
→ Monitor completion percentage

1. 防止上下文丢失：

Use auto_refresh before context limit
→ State saved to .appcreator/state.json
→ Continuation prompt generated
→ Resume seamlessly in new session

1. 添加功能：

Use add_feature to extend project
→ Project state updated
→ New tasks added to progress tracker
→ POML automatically updated

支持的项目类型

Web应用程序

• React、Vue、Angular、Svelte
• Types/JavaScript
• 现代构建工具（Vite、Webpack）
• 基于组件的体系结构

API服务器

• 表达，禁食，Koa
• REST和GraphQL
• MVC架构
• 中间件支持

CLI工具

• 基于节点的CLI框架
• 命令结构
• 参数解析
• 交互式提示

桌面应用程序

• 电子
• 涛瑞
• 与跨平台支持

移动应用程序

• React Native
• 离子
• 跨平台框架

图书馆

• npm包
• 模块捆绑
• 测试设置
• 文档

自动刷新系统详细信息

自动刷新系统是 关键的 为了防止上下文丢失：

何时使用：

• 在达到克劳德的上下文窗口限制之前
• 实现主要功能后
• 切换任务之前
• 在开发过程中的自然断点处

它节省了什么：

• 完成项目状态
• 所有进度跟踪数据
• 功能列表和状态
• 下一步行动和建议
• 文件结构和元数据

如何恢复：

1. 使用生成的继续提示
2. 从加载保存状态 .appcreator/state.json
3. 继续你停下来的地方
4. 无上下文丢失，无重复工作

最佳实践

1. 经常使用自动刷新：不要等到上下文已满
2. 定期更新POML：保持项目清单最新
3. 经常检查状态：使用get_project_status随时了解情况
4. 逐步添加功能：将大型功能分解为较小的任务
5. 审查生成的代码：AppCoreator创建结构，您添加逻辑
6. 定期承诺：对所有项目使用版本控制

故障排除

服务器无法启动

• 检查是否安装了所有依赖项： npm install
• 验证构建是否成功完成： npm run build
• 检查Node.js版本（需要Node 16+）

项目创建失败

• 确保项目名称不包含无效字符
• 检查目标目录中的写入权限
• 验证可用磁盘空间

状态不保存

• 检查 .appcreator 文件夹存在并且可写
• 验证项目路径是否正确
• 确保有足够的权限

贡献

AppCoreator被设计为可扩展的。要添加新的项目类型，请执行以下操作：

1. 将类型添加到 generateProjectStructure() 方法
2. 定义文件夹结构和文件
3. 创建适当的样板模板
4. 更新POML模板生成

许可证

ISC

支持

对于问题、疑问或功能请求，请在项目存储库上打开问题。

______________________________________________________________________

AppCreator -AI软件工厂 *将想法自动转化为可投入生产的项目*