cdk-agent-mcp-server

MCP server that generates, validates, and deploys AWS CDK infrastructure from natural language.

Delegates to AWS MCP servers for validation, documentation, and pricing — no duplicate tooling.

Architecture

cdk-agent-mcp-server (stdio)
  ├── clarify_requirements    → Bedrock (requirements gathering before design)
  ├── design_architecture     → AWS IaC MCP (search_cdk_documentation)
  ├── confirm_plan            → Bedrock (human/agent approval gate)
  ├── generate_cdk_stack      → AWS IaC MCP (search_cdk_documentation + search_cdk_samples_and_constructs)
  ├── validate_and_repair     → real cdk synth + AWS IaC MCP (validate_cloudformation_template + check_cloudformation_template_compliance)
  ├── estimate_cost           → AWS Pricing MCP (get_pricing + generate_cost_report)
  ├── lookup_cdk_construct    → AWS IaC MCP (search_cdk_documentation + search_cdk_samples_and_constructs + cdk_best_practices)
  ├── troubleshoot_deployment → AWS IaC MCP (troubleshoot_cloudformation_deployment)
  ├── deploy_stack            → real cdk deploy (requires approved=true)
  ├── destroy_stack           → CloudFormation DeleteStack (requires approved=true)
  ├── generate_diagram        → local Mermaid generation
  └── full_pipeline           → orchestrates all of the above

HITL (Human-in-the-Loop) Flow

User/Agent describes intent
       │
       ▼
clarify_requirements  →  returns structured questions + defaults
       │
       ▼
User/Agent answers (or accepts defaults)
       │
       ▼
design_architecture   →  generates plan using enriched context
       │
       ▼
confirm_plan          →  summarizes plan for approval (services, cost tier, security)
       │
       ▼
User/Agent approves (or modifies)
       │
       ▼
generate_cdk_stack → validate_and_repair → estimate_cost → deploy_stack

Prerequisites

• Python 3.10+, Node.js 18+ (for cdk synth/deploy), uv installed
• AWS CLI configured, Bedrock Claude Sonnet 4 enabled

Install

{
  "mcpServers": {
    "ict-mcp-server": {
      "command": "uvx",
      "args": ["ict-mcp-server"],
      "env": { "AWS_REGION": "us-east-1" }
    }
  }
}

Works with Kiro (~/.kiro/settings/mcp.json), Cursor (.cursor/mcp.json), Claude Code (claude mcp add), Amazon Quick Desktop (Settings → Capabilities → MCP).

Agent

What We Don't Reimplement

Our server only implements: architecture planning (Bedrock), CDK code generation (Bedrock), Mermaid diagrams (local), cdk synth/deploy (subprocess), and the orchestration glue.