Aurora Page Factory MCP

用于给产品生成 Aurora 风格后台页面预览的 MCP 服务。

重要定位：产品预览时跑的是临时预览工程；最终导出的不是新项目，而是可以合并进你们真实前端项目的页面交付包。

它负责：

• 创建独立页面预览会话
• 复制 Vue 2.7 + Element UI + @jerry965/aurora-element-ui 预览工程
• 写入 AI 生成的页面代码
• 启动 Vite 预览服务并返回 URL
• 根据产品反馈更新页面
• 导出最终“项目内页面代码包”给研发联调接口

启动

本 MCP 不要求 Windows，支持 Windows、macOS、Linux。客户机器只需要有 Node.js 和支持 MCP 的客户端。

npm install
npm start

MCP 客户端配置示例

推荐使用 npx，这样 Windows、macOS、Linux 都不用关心安装路径：

{
  "mcpServers": {
    "aurora-page-factory": {
      "command": "npx",
      "args": ["-y", "@jerry965/aurora-page-factory-mcp@latest"]
    }
  }
}

如果客户内网不能直接访问 npm，也可以先安装到本地，再用 node 启动本地包。

非 Codex Agent/IDE

这个 MCP 是标准 stdio MCP，不绑定 Codex。只要客户端支持 MCP，就可以接入，例如 Claude Desktop、Cursor、Windsurf、VS Code MCP 插件或自研 IDE Agent。

非 Codex agent 不会自动读取 Codex skill，可以先调用：

• get_generation_guide：获取页面生成规范、mock 数据规则和交付要求
• get_page_template：获取 Aurora 查询页 Vue 模板

内置内容保护

MCP 内置模板、生成规范和服务文件属于官方包内容，不作为客户可编辑资产交付。

• 客户和 agent 只能创建、修改、导出每次生成出来的页面代码。
• 不允许修改 npm 包里的内置模板、生成规范或 MCP 服务文件。
• 服务启动和关键工具调用时会校验内置内容完整性；如果发现被改过，会拒绝继续生成或导出。
• 可以调用 check_content_integrity 查看当前官方内置内容是否完整。
• 需要变更规则或模板时，应升级到官方发布的新 npm 版本。

说明：如果客户拥有本机文件系统管理员权限，任何本地 npm 包都无法做到物理层面的绝对防修改。这里的保护目标是产品和 agent 流程不可修改、运行时可发现篡改、交付包不包含可编辑的内部规则。

MCP 工具

• check_content_integrity：检查 MCP 官方内置内容是否被本地修改
• get_generation_guide：返回给任意 agent 使用的页面生成规范
• get_page_template：返回可作为起点的 Vue 页面模板
• create_preview_page：创建预览会话，返回 sessionId、previewUrl 和最终建议页面路径
• update_preview_page：修改已有会话里的文件，并保持预览可用
• get_preview_url：查询预览链接和服务状态
• list_preview_files：查看会话文件
• export_page_code：导出项目内页面交付包，只包含 project-files 和 docs
• stop_preview_session：停止预览进程

导出包结构

导出的 zip 结构类似：

project-files/
  src/views/ContractManagement.vue
docs/
  integration.md
  manifest.json

研发只需要把 project-files 下的文件合并进真实项目，再按 docs/integration.md 接菜单、路由和接口。

给 AI 的用法

产品提新页面需求时，AI 应先用 skill 生成 Vue 页面代码，再调用 create_preview_page 写入预览会话。产品调整时，AI 继续生成局部或完整文件内容，然后调用 update_preview_page。

创建页面时建议传入 projectPagePath，例如：

{
  "pageName": "合同管理",
  "projectPagePath": "src/views/contract/ContractManagement.vue"
}