awslabs.cdk-mcp-server 0.0.11704__py3-none-any.whl → 0.0.62303__py3-none-any.whl

awslabs/cdk_mcp_server/data/cdk_nag_parser.py

@@ -125,7 +125,7 @@ def format_rule_info(rule_info: Optional[Dict[str, str]]) -> str:
         A formatted markdown string.
     """
     if not rule_info:
-        return "Rule information not found."
+        return 'Rule information not found.'
 
     result = f'# {rule_info["rule_id"]}\n\n'
     result += f'## Cause\n\n{rule_info["cause"]}\n\n'
@@ -275,10 +275,10 @@ def check_cdk_nag_suppressions(
                 code = f.read()
         except Exception as e:
             return {'error': f'Failed to read file: {str(e)}', 'status': 'error'}
-    
+
     # Ensure code is not None at this point
     if code is None:
-        code = ""  # Default to empty string if somehow still None
+        code = ''  # Default to empty string if somehow still None
 
     # Define patterns to look for
     patterns = [

awslabs/cdk_mcp_server/data/genai_cdk_loader.py

@@ -364,7 +364,10 @@ def list_available_constructs(construct_type: Optional[str] = None) -> List[Dict
 
 
 def process_directory_files(
-    dir_path: str, construct_type: str, constructs: List[Dict[str, Any]], parent: Optional[str] = None
+    dir_path: str,
+    construct_type: str,
+    constructs: List[Dict[str, Any]],
+    parent: Optional[str] = None,
 ):
     """Process files in a directory and add them to the constructs list.
 
@@ -400,7 +403,7 @@ def process_directory_files(
 
         # Get description from fixed mapping or use default
         descriptions = get_construct_descriptions()
-        description = descriptions.get(display_name, "")
+        description = descriptions.get(display_name, '')
 
         # If no fixed description, fall back to current behavior
         if not description:

awslabs/cdk_mcp_server/data/schema_generator.py

@@ -484,12 +484,14 @@ def generate_bedrock_schema_from_file(
                         f'{module_name}_simplified', simplified_path
                     )
                     if spec is None:
-                        raise ImportError(f"Could not find spec for module: {module_name}_simplified")
-                    
+                        raise ImportError(
+                            f'Could not find spec for module: {module_name}_simplified'
+                        )
+
                     simplified_module = importlib.util.module_from_spec(spec)
                     if spec.loader is None:
-                        raise ImportError(f"Module spec has no loader: {module_name}_simplified")
-                        
+                        raise ImportError(f'Module spec has no loader: {module_name}_simplified')
+
                     spec.loader.exec_module(simplified_module)
 
                     # Get app and generate schema

awslabs/cdk_mcp_server/data/solutions_constructs_parser.py

@@ -33,11 +33,11 @@ async def fetch_pattern_list() -> List[str]:
         List of pattern names (e.g., ['aws-lambda-dynamodb', 'aws-apigateway-lambda', ...])
     """
     global _pattern_list_cache
-    
+
     # Initialize cache if it's None
     if _pattern_list_cache is None:
         _pattern_list_cache = {'timestamp': None, 'data': []}
-        
+
     # Check cache first
     if (
         _pattern_list_cache['timestamp'] is not None
@@ -135,7 +135,7 @@ async def get_pattern_info(pattern_name: str) -> Dict[str, Any]:
         # Update cache
         if _pattern_details_cache is None:
             _pattern_details_cache = {}
-            
+
         _pattern_details_cache[pattern_name] = {'timestamp': datetime.now(), 'data': pattern_info}
 
         return pattern_info

awslabs/cdk_mcp_server/static/CDK_GENERAL_GUIDANCE.md

@@ -1,6 +1,6 @@
-# AWS CDK Best Practices Guide
+# AWS CDK General Guidance
 
-This guide provides essential best practices for AWS CDK development, focusing on when to use specific constructs and tools.
+This guide provides essential guidance for AWS CDK development, focusing on when to use specific constructs and tools.
 
 ## Getting Started with CDK
 
@@ -15,12 +15,13 @@ cdk init app --language python
 ```
 
 Proper initialization ensures:
+
 - Consistent project structure
 - Correct dependency setup
 - Appropriate tsconfig/package.json configuration
 - Necessary boilerplate files
 
-This foundation helps avoid common issues and ensures compatibility with AWS CDK best practices.
+This foundation helps avoid common issues and ensures compatibility with the AWS CDK ecosystem.
 
 ## Development Workflow
 
@@ -61,6 +62,7 @@ When implementing AWS infrastructure with CDK, consider these complementary appr
    - Perfect for agents, knowledge bases, vector stores, and other GenAI components
 
    **Installation:**
+
    ```typescript
    // TypeScript
    // Create or use an existing CDK application
@@ -174,12 +176,14 @@ Always check the [Amazon Bedrock documentation](https://docs.aws.amazon.com/bedr
 AWS Solutions Constructs are vetted architecture patterns that combine multiple AWS services to solve common use cases following AWS Well-Architected best practices.
 
 **Key benefits:**
+
 - Accelerated Development: Implement common patterns without boilerplate code
 - Best Practices Built-in: Security, reliability, and performance best practices
 - Reduced Complexity: Simplified interfaces for multi-service architectures
 - Well-Architected: Patterns follow AWS Well-Architected Framework principles
 
 **When to use Solutions Constructs:**
+
 - Implementing common architecture patterns (e.g., API + Lambda + DynamoDB)
 - You want secure defaults and best practices applied automatically
 - You need to quickly prototype or build production-ready infrastructure
@@ -191,6 +195,7 @@ To discover available patterns, use the `GetAwsSolutionsConstructPattern` tool.
 CDK Nag is a crucial tool for ensuring your CDK applications follow AWS security best practices. **Always apply CDK Nag to all your stacks by default.**
 
 Key security practices to remember:
+
 - Follow the principle of least privilege for IAM
 - Secure S3 buckets with encryption, access controls, and policies
 - Implement secure authentication with Cognito
@@ -201,6 +206,7 @@ For detailed guidance, use the `CDKNagGuidance` tool.
 ## Operational Excellence with Lambda Powertools
 
 Always implement Lambda Powertools for:
+
 - Structured Logging
 - Tracing
 - Metrics

awslabs/cdk_mcp_server/static/__init__.py

@@ -1,5 +1,9 @@
 from importlib import resources
 
 
-with resources.files('awslabs.cdk_mcp_server.static').joinpath('CDK_GENERAL_GUIDANCE.md').open('r') as f:
+with (
+    resources.files('awslabs.cdk_mcp_server.static')
+    .joinpath('CDK_GENERAL_GUIDANCE.md')
+    .open('r') as f
+):
     CDK_GENERAL_GUIDANCE = f.read()

awslabs/cdk_mcp_server/static/bedrock/knowledgebases/chunking.md

@@ -62,7 +62,7 @@ ChunkingStrategy.HIERARCHICAL_COHERE;
 // Hierarchical Chunking with the default for Titan Models.
 ChunkingStrategy.HIERARCHICAL_TITAN;
 
-// Hierarchical Chunking with custom values. Tthe maximum chunk size depends on the model.
+// Hierarchical Chunking with custom values. The maximum chunk size depends on the model.
 // Amazon Titan Text Embeddings: 8192. Cohere Embed models: 512
 ChunkingStrategy.hierarchical({
   overlapTokens: 60,
@@ -80,7 +80,7 @@ ChunkingStrategy.HIERARCHICAL_COHERE
 # Hierarchical Chunking with the default for Titan Models.
 ChunkingStrategy.HIERARCHICAL_TITAN
 
-# Hierarchical Chunking with custom values. Tthe maximum chunk size depends on the model.
+# Hierarchical Chunking with custom values. The maximum chunk size depends on the model.
 # Amazon Titan Text Embeddings: 8192. Cohere Embed models: 512
 chunking_strategy= ChunkingStrategy.hierarchical(
     overlap_tokens=60,

awslabs_cdk_mcp_server-0.0.62303.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: awslabs.cdk-mcp-server
+Version: 0.0.62303
+Summary: 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. This server offers tools to validate infrastructure designs, explain CDK Nag rules, analyze suppressions, generate Bedrock Agent schemas, and discover Solutions Constructs patterns.
+Requires-Python: >=3.10
+Requires-Dist: aws-lambda-powertools>=2.30.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: pydantic>=2.10.6
+Description-Content-Type: text/markdown
+
+# AWS CDK MCP Server
+
+MCP server for AWS Cloud Development Kit (CDK) best practices, infrastructure as code patterns, and security compliance with CDK Nag.
+
+## Features
+
+### CDK General Guidance
+
+- Prescriptive patterns with AWS Solutions Constructs and GenAI CDK libraries
+- Structured decision flow for choosing appropriate implementation approaches
+- Security automation through CDK Nag integration and Lambda Powertools
+
+### CDK Nag Integration
+
+- Work with CDK Nag rules for security and compliance
+- Explain specific CDK Nag rules with AWS Well-Architected guidance
+- Check if CDK code contains Nag suppressions that require human review
+
+### AWS Solutions Constructs
+
+- Search and discover AWS Solutions Constructs patterns
+- Find recommended patterns for common architecture needs
+- Get detailed documentation on Solutions Constructs
+
+### Generative AI CDK Constructs
+
+- Search for GenAI CDK constructs by name or type
+- Discover specialized constructs for AI/ML workloads
+- Get implementation guidance for generative AI applications
+
+### Amazon Bedrock Agent Schema Generation
+
+- Generate OpenAPI schema for Bedrock Agent Action Groups
+- Streamline the creation of Bedrock Agent schemas
+- Convert code files to compatible OpenAPI specifications
+
+## Tools and Resources
+
+- **CDK Nag Rules**: Access rule packs via `cdk-nag://rules/{rule_pack}`
+- **Lambda Powertools**: Get guidance on Lambda Powertools via `lambda-powertools://{topic}`
+- **AWS Solutions Constructs**: Access patterns via `aws-solutions-constructs://{pattern_name}`
+- **GenAI CDK Constructs**: Access documentation via `genai-cdk-constructs://{construct_type}/{construct_name}`
+
+## Prerequisites
+
+1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
+2. Install Python using `uv python install 3.10`
+
+## Installation
+
+Here are some ways you can work with MCP across AWS, and we'll be adding support to more products including Amazon Q Developer CLI soon: (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "awslabs.cdk-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.cdk-mcp-server@latest"],
+      "env": {
+        "FASTMCP_LOG_LEVEL": "ERROR"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+## Security Considerations
+
+When using this MCP server, you should consider:
+
+- Reviewing all CDK Nag warnings and errors manually
+- Fixing security issues rather than suppressing them whenever possible
+- Documenting clear justifications for any necessary suppressions
+- Using the CheckCDKNagSuppressions tool to verify no unauthorized suppressions exist
+
+Before applying CDK NAG Suppressions, you should consider conducting your own independent assessment to ensure that your use would comply with your own specific security and quality control practices and standards, as well as the local laws, rules, and regulations that govern you and your content.

{awslabs_cdk_mcp_server-0.0.11704.dist-info → awslabs_cdk_mcp_server-0.0.62303.dist-info}/RECORD

@@ -7,15 +7,15 @@ awslabs/cdk_mcp_server/core/search_utils.py,sha256=Nz8ftv4w9O_1fvCwIJL36GoBMOtHP
 awslabs/cdk_mcp_server/core/server.py,sha256=1Zc_n4whZJq9q2_eVrmvqnmNaTKL4ftwbiVHmPJ3JAs,2594
 awslabs/cdk_mcp_server/core/tools.py,sha256=dw_RJ-IvfWsaicj6bp_UvyGjtd2hLicXL4RC5doaVk4,11644
 awslabs/cdk_mcp_server/data/__init__.py,sha256=ksA1se4fyvTIb4K7lND-C66ouriFtjyZU96Q88nl6w4,47
-awslabs/cdk_mcp_server/data/cdk_nag_parser.py,sha256=z74FJY3XuIJIxUUd_EbpvBuBRBLf5ZWDr39pdEwk5cE,10904
+awslabs/cdk_mcp_server/data/cdk_nag_parser.py,sha256=k3OzuVyoYUivowt_mEO0cp1YwTOgzTmVyg_0mcanDt8,10900
 awslabs/cdk_mcp_server/data/construct_descriptions.py,sha256=br5gOa5M8Nhv3HrHqrHGXCwQRTu4ZeMAo85bEhzCuMM,2605
-awslabs/cdk_mcp_server/data/genai_cdk_loader.py,sha256=6YqW9ODyw8Gd2I05Suxuo1HPKrB8JPzuzm8CI-psD0E,15494
+awslabs/cdk_mcp_server/data/genai_cdk_loader.py,sha256=Q_-tnYu9VNe9lbAxN6qfvBQWYJJjYXht63ko9x-IH-Y,15507
 awslabs/cdk_mcp_server/data/lambda_powertools_loader.py,sha256=sQfZrmA2hZdd1NSK0hCb5l4kl7jlQ3xhxs28KgEB4Dw,1630
-awslabs/cdk_mcp_server/data/schema_generator.py,sha256=bqEOMCFy0pWw52v66Zobn6xrn0wHLJzOZF3XuKGDfdc,27869
-awslabs/cdk_mcp_server/data/solutions_constructs_parser.py,sha256=IMGXBGkDB8W8SnZuXfspZ0JD8jc4CiRd_KH7HR6HwzE,27680
-awslabs/cdk_mcp_server/static/CDK_GENERAL_GUIDANCE.md,sha256=RAYowPS-9I8dq7YQOPLEAgQ4i9anoQcyRdC2E2_dX_I,9930
+awslabs/cdk_mcp_server/data/schema_generator.py,sha256=vQaZiasOyVam0NNmtzo6D6hy7ynsndRR2I56OBwQlag,27879
+awslabs/cdk_mcp_server/data/solutions_constructs_parser.py,sha256=SL3ZjvCSALmiQlHEMsoDbnbtKxFAPl-mTurciCgj3G8,27656
+awslabs/cdk_mcp_server/static/CDK_GENERAL_GUIDANCE.md,sha256=E-oIFBGkvHg95u909rJDrGJdo4t7aCeTLZsXQ47Fyhc,9925
 awslabs/cdk_mcp_server/static/CDK_NAG_GUIDANCE.md,sha256=zJtHJp9ruaaJ-xa68k9kDrPmEaXpiWCZZf7JIy8NK0w,5839
-awslabs/cdk_mcp_server/static/__init__.py,sha256=NybWQKuqEx70DXtHCJ5LuFuRn-AOF9M-NjDSiyev6Og,176
+awslabs/cdk_mcp_server/static/__init__.py,sha256=JJ9ptA-cG8muKCoJgjPKUoCc2q2ks8gBJNbjJTHZS3o,194
 awslabs/cdk_mcp_server/static/bedrock/bedrockguardrails.md,sha256=CX00B7XgDpLbVxvf6B-a13O4NERAJMiaPPeTuKK-8Sw,7386
 awslabs/cdk_mcp_server/static/bedrock/profiles.md,sha256=xxPnEkZ0tJAFKomMuAPLm3EtlQFku6MR2nPu4VoyppE,7195
 awslabs/cdk_mcp_server/static/bedrock/agent/actiongroups.md,sha256=qm6UCCfKurtvNO52g1a6H1N9iBZx-KTCf4SbCK2QQXw,4865
@@ -25,7 +25,7 @@ awslabs/cdk_mcp_server/static/bedrock/agent/creation.md,sha256=BzpVJkRs_q1ZkW8Ln
 awslabs/cdk_mcp_server/static/bedrock/agent/custom_orchestration.md,sha256=ylMTq3PT3vHnrul_boLuQIGQFuk_Y0evdImp_pLY7rY,2983
 awslabs/cdk_mcp_server/static/bedrock/agent/overview.md,sha256=4FLhC3CC01W9Gpw4S0Z6yWPnM86p2nJ_dxQ1yU4Xsxw,2921
 awslabs/cdk_mcp_server/static/bedrock/agent/prompt_override.md,sha256=ypmKxlO5WIYqUh2gYDzo1Mwzso_HwSkzrMHeDU473C8,2520
-awslabs/cdk_mcp_server/static/bedrock/knowledgebases/chunking.md,sha256=TpLXPJso6c4MhWUepX0WsX3FE6FOIsFBPcE28B-3iKM,3203
+awslabs/cdk_mcp_server/static/bedrock/knowledgebases/chunking.md,sha256=xlO23xjesPFGgv_FZm2AkRzQVH3nSFD2GpbddXJX2gM,3201
 awslabs/cdk_mcp_server/static/bedrock/knowledgebases/datasources.md,sha256=iHQ086zHzkqHoKLi7pmyMxf0oH02UVHf_GAid6EMdeE,7147
 awslabs/cdk_mcp_server/static/bedrock/knowledgebases/kendra.md,sha256=sYbhIAaGjuJ2lifP0xvDXacDEVFC24Gl9giAI6RF9bo,2786
 awslabs/cdk_mcp_server/static/bedrock/knowledgebases/overview.md,sha256=AGLS6146UufRTC80EAyAviBhAtb7hFcbMz3tWFviPOc,5167
@@ -66,7 +66,7 @@ awslabs/cdk_mcp_server/static/lambda_powertools/metrics.md,sha256=XpQHtNSQRKN3GU
 awslabs/cdk_mcp_server/static/lambda_powertools/tracing.md,sha256=Q3dSCvgktb9sUsuuQ5ONU2Qdb1OTwbNOYpK--MDzBNw,2539
 awslabs/cdk_mcp_server/static/opensearch-vectorindex/overview.md,sha256=0aSuBwX4ubI5WqwEfrnX1MH2UJlJOzdXZQ003fRIrGM,4121
 awslabs/cdk_mcp_server/static/opensearchserverless/overview.md,sha256=aUO1BRana_xqUPENP3GQyOSCAvV9mI-ZWls7x0g8ruA,746
-awslabs_cdk_mcp_server-0.0.11704.dist-info/METADATA,sha256=3w3EIC6V8L7yoy_2JlXaBOVyrQ4SBXqlWqtTA1Go8F8,3064
-awslabs_cdk_mcp_server-0.0.11704.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_cdk_mcp_server-0.0.11704.dist-info/entry_points.txt,sha256=LertzmID_mUU1YYZPySAF1IY1zE7ySTvzFxiGyo3VjY,78
-awslabs_cdk_mcp_server-0.0.11704.dist-info/RECORD,,
+awslabs_cdk_mcp_server-0.0.62303.dist-info/METADATA,sha256=FFFL7SlFEWlvq9ThUjvrIJ9aZAs0lM5NUcJImlz1AkU,3638
+awslabs_cdk_mcp_server-0.0.62303.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_cdk_mcp_server-0.0.62303.dist-info/entry_points.txt,sha256=LertzmID_mUU1YYZPySAF1IY1zE7ySTvzFxiGyo3VjY,78
+awslabs_cdk_mcp_server-0.0.62303.dist-info/RECORD,,

awslabs_cdk_mcp_server-0.0.11704.dist-info/METADATA

@@ -1,65 +0,0 @@
-Metadata-Version: 2.4
-Name: awslabs.cdk-mcp-server
-Version: 0.0.11704
-Summary: 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. This server offers tools to validate infrastructure designs, explain CDK Nag rules, analyze suppressions, generate Bedrock Agent schemas, and discover Solutions Constructs patterns.
-Requires-Python: >=3.13
-Requires-Dist: aws-lambda-powertools>=2.30.0
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: mcp[cli]>=1.6.0
-Requires-Dist: pydantic>=2.10.6
-Description-Content-Type: text/markdown
-
-# CDK MCP Server
-
-MCP server for AWS Cloud Development Kit (CDK) best practices, infrastructure as code patterns, and security compliance with CDK Nag.
-
-## Features
-
-### Tools
-
-- **CDKGeneralGuidance** - Get prescriptive CDK advice for building applications on AWS
-- **ExplainCDKNagRule** - Explain specific CDK Nag rules with AWS Well-Architected guidance
-- **CheckCDKNagSuppressions** - Check if CDK code contains Nag suppressions that require human review
-- **GenerateBedrockAgentSchemaFromFile** - Generate OpenAPI schema for Bedrock Agent Action Groups from a file
-- **GetAwsSolutionsConstructPattern** - Search and discover AWS Solutions Constructs patterns
-- **SearchGenAICDKConstructs** - Search for GenAI CDK constructs by name or type
-
-### Resources
-
-- **CDK Nag Rules** - Access rule packs via `cdk-nag://rules/{rule_pack}`
-- **Lambda Powertools** - Get guidance on Lambda Powertools via `lambda-powertools://{topic}`
-- **AWS Solutions Constructs** - Access patterns via `aws-solutions-constructs://{pattern_name}`
-- **GenAI CDK Constructs** - Access documentation via `genai-cdk-constructs://{construct_type}/{construct_name}`
-
-## Prerequisites
-
-1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
-2. Install Python using `uv python install 3.13`
-
-## Installation
-
-Here are some ways you can work with MCP across AWS, and we’ll be adding support to more products including Amazon Q Developer CLI soon: (e.g. for Amazon Q DeveloperCLI MCP, `~/.aws/amazonq/mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "awslabs.cdk-mcp-server": {
-      "command": "uvx",
-      "args": ["awslabs.cdk-mcp-server@latest"],
-      "disabled": false,
-      "autoApprove": []
-    }
-  }
-}
-```
-
-## Security Considerations
-
-When using this MCP server, you should consider:
-
-- Reviewing all CDK Nag warnings and errors manually
-- Fixing security issues rather than suppressing them whenever possible
-- Documenting clear justifications for any necessary suppressions
-- Using the CheckCDKNagSuppressions tool to verify no unauthorized suppressions exist
-
-Before applying CDK NAG Suppressions, you should consider conducting your own independent assessment to ensure that your use would comply with your own specific security and quality control practices and standards, as well as the local laws, rules, and regulations that govern you and your content.