{"id":23039,"library":"awslabs-cdk-mcp-server","title":"AWS CDK MCP Server","description":"An AWS CDK MCP server that provides guidance on AWS Cloud Development Kit best practices, infrastructure as code patterns, and security compliance with CDK Nag. It offers tools to validate infrastructure designs, explain CDK Nag rules, analyze suppressions, generate Bedrock Agent schemas, and discover Solutions Constructs patterns. Current version: 1.0.15. Release cadence: active development, minor releases as needed.","status":"active","version":"1.0.15","language":"python","source_language":"en","source_url":"https://github.com/awslabs/mcp.git","tags":["aws","cdk","mcp","infrastructure","best-practices","cdk-nag"],"install":[{"cmd":"pip install awslabs-cdk-mcp-server","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for CDK constructs and Nag integration.","package":"aws-cdk-lib","optional":false},{"reason":"Required for CDK Nag rule analysis and suppression.","package":"cdk-nag","optional":false},{"reason":"Required for Bedrock Agent schema generation.","package":"boto3","optional":true}],"imports":[{"note":"Hyphen in package name becomes underscore in Python imports.","wrong":"from awslabs-cdk-mcp-server import CdkMcpServer","symbol":"CdkMcpServer","correct":"from awslabs_cdk_mcp_server import CdkMcpServer"},{"note":"The top-level import is the preferred pattern.","wrong":"from awslabs_cdk_mcp_server.cli import run_server","symbol":"run_server","correct":"from awslabs_cdk_mcp_server import run_server"}],"quickstart":{"code":"from awslabs_cdk_mcp_server import run_server\nimport os\n\n# Set up AWS credentials via environment variables (or use default session)\nos.environ.setdefault(\"AWS_REGION\", \"us-east-1\")\n\n# Start the MCP server\nrun_server(\n    aws_region=os.environ.get(\"AWS_REGION\", \"\"),\n    profile=\"default\",\n    require_approval=True\n)","lang":"python","description":"Starts the CDK MCP server. The server listens for MCP requests to validate CDK stacks, explain Nag rules, etc. Requires AWS credentials configured."},"warnings":[{"fix":"Upgrade Python to 3.10+ or use a compatible environment.","message":"Python 3.10 or higher is required. Using Python <3.10 will cause import errors.","severity":"breaking","affected_versions":"all"},{"fix":"Import with underscores: from awslabs_cdk_mcp_server import ...","message":"Package import path uses underscores: 'awslabs_cdk_mcp_server' (not hyphens). Common mistake leads to ModuleNotFoundError.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'require_confirmation' if available in newer versions, or monitor changelog.","message":"The 'require_approval' parameter may be renamed or removed in future versions. Check latest docs.","severity":"deprecated","affected_versions":"<1.1.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install awslabs-cdk-mcp-server' and import as 'awslabs_cdk_mcp_server'.","cause":"Package not installed or import path uses hyphen instead of underscore.","error":"ModuleNotFoundError: No module named 'awslabs_cdk_mcp_server'"},{"fix":"Use 'from awslabs_cdk_mcp_server import run_server' instead, or check the package __init__.py.","cause":"Symbol might be renamed or not exported at top level.","error":"ImportError: cannot import name 'CdkMcpServer' from 'awslabs_cdk_mcp_server'"},{"fix":"Set AWS_REGION environment variable or configure a region in your AWS profile.","cause":"AWS_REGION environment variable not set or profile missing region.","error":"RuntimeError: AWS region not configured"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}