Agent Cloud Architect

云架构师

任何项目的云架构分析、建议和工件。作为一个 MCP服务器 用于AI驱动的编码工具（Claude Code、Cursor、Windsurf）或作为 独立CLI.

扫描您的项目，检测您的堆栈，并为AWS、GCP或Azure提供架构建议、图表、决策记录和部署比较。

安装

npm install -g github:bmdietrich/agent-cloud-architect

用法

命令行界面

# Analyze a project and get architecture recommendations
cloud-architect analyze --provider aws --dir /path/to/project

# Generate a Mermaid architecture diagram
cloud-architect diagram --provider gcp --style mermaid

# Review against well-architected framework
cloud-architect review --provider azure --checklist security reliability cost

# Compare deployment options
cloud-architect compare --provider aws --options ecs-fargate eks lambda

# Generate an Architecture Decision Record
cloud-architect adr "Use Fargate for backend services" --context "Migrating from EC2"

# Ask a question using the agentic loop (requires ANTHROPIC_API_KEY)
cloud-architect ask "What's the best way to handle background jobs?" --provider aws

所有命令都接受：

• -p, --provider --云提供商（默认值： aws)
• `-d, --dir

` --要分析的项目目录（默认：cwd）

MCP服务器

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "cloud-architect": {
      "command": "npx",
      "args": ["-y", "github:bmdietrich/agent-cloud-architect"],
      "env": {
        "PROJECT_DIR": ".",
        "CLOUD_PROVIDER": "aws"
      }
    }
  }
}

或者通过Claude Code CLI注册：

claude mcp add cloud-architect \
  -e PROJECT_DIR=. \
  -e CLOUD_PROVIDER=aws \
  -- npx -y github:bmdietrich/agent-cloud-architect

工具

运作原理

项目扫描仪

上下文扫描程序检测到：

• 语言 --JavaScript、TypeScript、Python、Go、Rust、Java、Kotlin
• 框架 --React、Next.js、Express、NestJS、FastAPI、Django、Spring等
• 数据库 --MongoDB、PostgreSQL、MySQL、Redis、DynamoDB、RabbitMQ、Kafka
• 基础设施 --Terraform、无服务器框架、CDK、CloudFormation
• 容器 --Dockerfiles、Docker Compose、Kubernetes清单
• CI/CD --GitHub Actions、GitLab CI、Jenkins、CircleCI、CodeBuild
• 服务 --使用类型推断检测monorepos中的单个服务（前端、后端、worker、lambda）

提供者参数化

这 cloudProvider 设置将塑造所有输出——服务名称、架构模式和推荐映射到目标提供者：

MCP模式与CLI模式

MCP模式 --主机AI（Claude、Cursor等）是推理层。工具返回结构化分析，人工智能解释并应用它。不需要API密钥。

CLI模式 --工具直接运行并返回markdown输出。这 ask 命令和 --agent flag使用Claude的代理循环来提供交互式分析（需要 ANTHROPIC_API_KEY).

环境变量

发展

git clone github:bmdietrich/agent-cloud-architect
cd cloud-architect
npm install
npm run dev          # watch mode
npm run build        # one-time build

许可证

麻省理工学院