MCP Cloudformation Builder

MCP云形成生成器

AI原生CloudFormation/Terraform生成器，首次部署准确率为99.5%

______________________________________________________________________

🎯 概述

MCP CloudFormation Builder是为DeveloperLabs AI产品提供动力的核心基础设施编排引擎。它提供：

• 云层生成：从GitHub存储库生成AI驱动的模板
• 自愈系统：通过模式数据库自动检测和修复错误
• MCP编排：Claude驱动的基础设施的模型上下文协议集成
• 图案数据库：网络效应驱动精度提高（99.5%+成功率）
• 地形支撑：多IaC格式生成
• 成本估算：AWS定价API集成

______________________________________________________________________

🔒 重要提示：这是一个私有存储库

此代码库包含DeveloperLabs AI的专有编排引擎。它不会分发给白标客户。外部产品（lead-magnet，ISV演示）通过内部API调用此功能。

______________________________________________________________________

🏗️ 建筑

External Products (lead-magnet, ISV demo)
    ↓
Internal API (/api/internal/*)
    ↓
MCP CloudFormation Builder (THIS REPO)
    ├── CloudFormation Generator
    ├── Self-Healing Engine
    ├── Pattern Database
    ├── RAG System
    └── AWS Deployment

______________________________________________________________________

🚀 快速开始

先决条件

• Node.js 18+
• Supabase账户
• 具有适当权限的AWS帐户
• 无烟煤API键

安装

# Clone repository
cd ~/Projects/mcp-cloudformation-builder

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Run database migrations
# (Connect to your Supabase project first)

# Start development server
npm run dev

API将于 http://localhost:3001

______________________________________________________________________

📚 API文档

API内部端点

这些端点仅供其他DeveloperLabs产品内部使用。他们要求 INTERNAL_API_SECRET 身份验证。

POST /api/internal/generate-cloudformation

从GitHub存储库生成CloudFormation模板。

请求:

{
  "repository_url": "https://github.com/user/repo",
  "environment": "dev" | "staging" | "prod",
  "region": "us-east-1",
  "partner_id": "uuid",
  "user_id": "uuid",
  "options": {
    "enable_healing": true,
    "use_pattern_db": true,
    "cost_analysis": true
  }
}

回应:

{
  "success": true,
  "template": "AWSTemplateFormatVersion: '2010-09-09'...",
  "metadata": {
    "accuracy_score": 99.5,
    "healing_applied": false,
    "pattern_db_hit": true,
    "generation_time_ms": 850,
    "estimated_cost": {
      "monthly": 247.50,
      "currency": "USD"
    }
  }
}

______________________________________________________________________

🧠 核心组件

1.云形成生成器(src/lib/cloudformation/)

• generator.ts -主生成逻辑
• validator.ts -AWS模板验证
• healer.ts -Kiro自愈发动机
• orchestrator.ts -MCP/Spec Kit编排

2.自愈系统(src/lib/self-healing/)

• pattern-detector.ts -错误模式识别
• auto-fix-generator.ts -自动修复生成
• intelligence-report-generator.ts -分析和见解

3.存储库分析(src/lib/repo-analysis/)

• analyzer.ts -存储库结构分析
• github-api.ts -GitHub API集成

4.AWS集成(src/lib/aws/)

• sdk-utils.ts -AWS SDK实用程序
• pricing.ts -AWS定价API
• pricing-models.ts -成本计算逻辑

______________________________________________________________________

🗄️ 数据库模式

核心表

• cloudformation_templates -生成的模板
• template_deployment_logs -部署跟踪
• template_auto_fixes -自愈模式
• repository_version_tracking -SpecKit缓存
• error_solutions -模式数据库（关键-网络效应护城河）

支撑桌

• pricing_cache -AWS定价数据
• user_github_analyses -分析历史
• terraform_generations -地形模板
• credit_system -使用情况跟踪

______________________________________________________________________

🔧 发展

运行测试

npm test

生产大楼

npm run build
npm start

环境变量

看 .env.example 对于所需的环境变量。

______________________________________________________________________

📊 成功指标

技术指标

• CloudFormation生成精度： >99.5%
• API响应时间： \80%
• 自愈成功率： >95%

商业米制公约

• 每天API调用
• 每代成本
• 错误率： \<0.5%

______________________________________________________________________

🚢 部署

生产基础结构

• 平台：Vercel（Next.js API路线）
• 数据库：Supabase（PostgreSQL）
• 亚马逊云服务：用于部署测试和定价
• 领域: api-internal.developerlabs.ai （仅限内部）

部署步骤

1. 推到 main 分支
2. Vercel自动部署
3. 在生产Supabase上运行数据库迁移
4. 验证内部API终结点
5. 更新 INTERNAL_API_SECRET 在消费服务中

______________________________________________________________________

📖 文档

• API文档
• 架构指南
• 自愈系统

______________________________________________________________________

🔐 安全

• 内部API要求 INTERNAL_API_SECRET 头球
• 数据库使用行级安全性（RLS）
• 存储在环境变量中的AWS凭据（从不存储在代码中）
• 记录所有API调用以进行审核跟踪

______________________________________________________________________

📝 许可证

专有-DeveloperLabs AI

______________________________________________________________________

📞 支持

内部支持：clance@developerlabs.ai

______________________________________________________________________

内置于❤️ 开发者实验室AI