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

awslabs/cdk_mcp_server/static/CDK_GENERAL_GUIDANCE.md

@@ -105,67 +105,20 @@ When implementing AWS infrastructure with CDK, consider these complementary appr
 
 ## Amazon Bedrock Cross-Region Inference Profiles
 
-When working with Amazon Bedrock foundation models, many models (including Claude models, Meta Llama models, and Amazon's own Nova models) require the use of inference profiles rather than direct on-demand usage in specific regions. Failing to use inference profiles can result in errors like:
+When working with Amazon Bedrock foundation models, many models (including Claude models, Meta Llama models, and Amazon's own Nova models) require the use of inference profiles rather than direct on-demand usage in specific regions.
 
-```
-Invocation of model ID anthropic.claude-3-7-sonnet-20250219-v1:0 with on-demand throughput isn't supported.
-Retry your request with the ID or ARN of an inference profile that contains this model.
-```
-
-### Using Cross-Region Inference Profiles
+### Key Considerations
 
-To properly configure Bedrock models with cross-region inference profiles:
+- **Required for Many Models**: Foundation models like Claude 3 often require inference profiles
+- **Regional Configuration**: Profiles are configured for specific geographic regions (US, EU, APAC)
+- **Error Prevention**: Prevents errors like "Invocation with on-demand throughput isn't supported"
+- **Implementation**: Use the `CrossRegionInferenceProfile` class from the GenAI CDK constructs
 
-#### TypeScript
-
-```typescript
-import { bedrock } from '@cdklabs/generative-ai-cdk-constructs';
-
-// Create a cross-region inference profile for Claude
-const claudeInferenceProfile = bedrock.CrossRegionInferenceProfile.fromConfig({
-  // Choose the appropriate region:
-  // US (default) - bedrock.CrossRegionInferenceProfileRegion.US
-  // EU - bedrock.CrossRegionInferenceProfileRegion.EU
-  // APAC - bedrock.CrossRegionInferenceProfileRegion.APAC
-  geoRegion: bedrock.CrossRegionInferenceProfileRegion.US,
-  model: bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_7_SONNET_V1_0
-});
-
-// Use the inference profile with your agent or other Bedrock resources
-const agent = new bedrock.Agent(this, 'MyAgent', {
-  // Use the inference profile instead of directly using the foundation model
-  foundationModel: claudeInferenceProfile,
-  // Other agent configuration...
-});
-```
-
-#### Python
-
-```python
-from cdklabs.generative_ai_cdk_constructs import bedrock
-
-# Create a cross-region inference profile for Claude
-claude_inference_profile = bedrock.CrossRegionInferenceProfile.from_config(
-    # Choose the appropriate region:
-    # US (default) - bedrock.CrossRegionInferenceProfileRegion.US
-    # EU - bedrock.CrossRegionInferenceProfileRegion.EU
-    # APAC - bedrock.CrossRegionInferenceProfileRegion.APAC
-    geo_region=bedrock.CrossRegionInferenceProfileRegion.US,
-    model=bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_7_SONNET_V1_0
-)
-
-# Use the inference profile with your agent or other Bedrock resources
-agent = bedrock.Agent(self, "MyAgent",
-    # Use the inference profile instead of directly using the foundation model
-    foundation_model=claude_inference_profile,
-    # Other agent configuration...
-)
-```
+For detailed implementation examples, see the `genai-cdk-constructs://bedrock/profiles` resource.
 
 ### Regional Considerations
 
 - **Model Availability**: Not all foundation models are available in all regions
-- **Inference Profile Requirements**: Some models require inference profiles in specific regions
 - **Performance**: Choose the region closest to your users for optimal latency
 - **Compliance**: Consider data residency requirements when selecting regions
 
@@ -192,26 +145,115 @@ To discover available patterns, use the `GetAwsSolutionsConstructPattern` tool.
 
 ## Security with CDK Nag
 
-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.**
+CDK Nag ensures your CDK applications follow AWS security best practices. **Always apply CDK Nag to all stacks.**
 
-Key security practices to remember:
+**When to use CDK Nag tools:**
+- **ExplainCDKNagRule**: When encountering warnings that need remediation
+- **CheckCDKNagSuppressions**: During code reviews to verify suppression justifications
 
-- Follow the principle of least privilege for IAM
-- Secure S3 buckets with encryption, access controls, and policies
+Key security practices:
+- Follow least privilege for IAM
+- Secure S3 buckets with encryption and access controls
 - Implement secure authentication with Cognito
 - Secure API Gateway endpoints with proper authorization
 
-For detailed guidance, use the `CDKNagGuidance` tool.
-
 ## Operational Excellence with Lambda Powertools
 
-Always implement Lambda Powertools for:
+**Always implement Lambda Powertools** for structured logging, tracing, and metrics. For detailed guidance, use the `lambda-powertools://cdk` resource.
+
+## Tool Selection Guide
+
+Match CDK tasks to appropriate tools:
+
+| Task | Tool | Common Mistakes |
+|------|------|-----------------|
+| Generate Bedrock Agent schema | GenerateBedrockAgentSchema | ❌ Missing schema generation or not running script to create openapi.json |
+| Understand CDK Nag rules | ExplainCDKNagRule | ❌ Ignoring security warnings without understanding remediation steps |
+| Find architecture patterns | GetAwsSolutionsConstructPattern | ❌ Building common patterns from scratch instead of using vetted constructs |
+| Implement GenAI features | SearchGenAICDKConstructs | ❌ Building GenAI components without specialized constructs |
+| Add Lambda observability | lambda-powertools://cdk | ❌ Missing Layer creation, structured logging and monitoring |
+| Audit CDK Nag suppressions | CheckCDKNagSuppressions | ❌ Insufficient documentation for security suppressions |
+
+## Lambda Powertools Implementation
+
+> **CRITICAL:** All Lambda functions should implement Lambda Powertools for proper observability.
 
-- Structured Logging
-- Tracing
-- Metrics
+**Key requirements:**
+- Use language-specific constructs (PythonFunction, NodejsFunction)
+- Include Powertools dependencies with appropriate extras
+- Configure required environment variables
+- Create Lambda layers when needed
 
-For detailed guidance, use the `LambdaPowertoolsGuidance` tool.
+**Example Lambda layer for Python:**
+```typescript
+const lambdaPowertoolsLayer = new PythonLayerVersion(this, "LambdaPowertoolsLayer", {
+  entry: path.join("src", "layers", "aws_lambda_powertools"),
+  compatibleRuntimes: [Runtime.PYTHON_3_13],
+  description: "Lambda Powertools for Python",
+});
+```
+
+For complete implementation details and examples for all languages, see the [lambda-powertools://cdk](lambda-powertools://cdk) resource.
+
+## CDK Implementation Workflow
+
+```mermaid
+graph TD
+    Start([Start]) --> Init["cdk init app"]
+    
+    Init --> B{Choose Approach}
+    B -->|"Common Patterns"| C1["GetAwsSolutionsConstructPattern"]
+    B -->|"GenAI Features"| C2["SearchGenAICDKConstructs"]
+    B -->|"Custom Needs"| C3["Custom CDK Code"]
+    
+    C1 --> D1["Implement Solutions Construct"]
+    C2 --> D2["Implement GenAI Constructs"]
+    C3 --> D3["Implement Custom Resources"]
+    
+    %% Bedrock Agent with Action Groups specific flow
+    D2 -->|"For Bedrock Agents<br/>with Action Groups"| BA["Create Lambda with<br/>BedrockAgentResolver"]
+    
+    %% Schema generation flow
+    BA --> BS["GenerateBedrockAgentSchema"]
+    BS -->|"Success"| JSON["openapi.json created"]
+    BS -->|"Import Errors"| BSF["Tool generates<br/>generate_schema.py"]
+    BSF --> BSR["Run script manually:<br/>python generate_schema.py"]
+    BSR --> JSON["openapi.json created"]
+    
+    %% Use schema in Agent CDK
+    JSON --> AgentCDK["Use schema in<br/>Agent CDK code"]
+    AgentCDK --> D2
+    
+    %% Conditional Lambda Powertools implementation
+    D1 & D2 & D3 --> HasLambda{"Using Lambda<br/>Functions?"}
+    HasLambda -->|"Yes"| L["Add Lambda Powertools<br/>and create Layer"]
+    HasLambda -->|"No"| SkipL["Skip Lambda<br/>Powertools"]
+    
+    %% Rest of workflow
+    L --> Synth["cdk synth"]
+    SkipL --> Synth
+    
+    Synth --> Nag{"CDK Nag<br/>warnings?"}
+    Nag -->|Yes| E["ExplainCDKNagRule"]
+    Nag -->|No| Deploy["cdk deploy"]
+    
+    E --> Fix["Fix or Add Suppressions"]
+    Fix --> CN["CheckCDKNagSuppressions"]
+    CN --> Synth
+    
+    %% Styling with darker colors
+    classDef default fill:#424242,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef cmd fill:#4a148c,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef tool fill:#01579b,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef note fill:#1b5e20,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef output fill:#006064,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef decision fill:#5d4037,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    
+    class Init,Synth,Deploy,BSR cmd;
+    class C1,C2,BS,E,CN tool;
+    class JSON output;
+    class HasLambda,Nag decision;
+```
 
 ## Available MCP Tools
 
@@ -220,7 +262,7 @@ This MCP server provides several tools to help you implement AWS CDK best practi
 1. **CDKGeneralGuidance**: This document - general CDK best practices
 2. **ExplainCDKNagRule**: Explain a specific CDK Nag rule with AWS Well-Architected guidance
 3. **CheckCDKNagSuppressions**: Check if CDK code contains Nag suppressions that require human review
-4. **GenerateBedrockAgentSchemaFromFile**: Generate OpenAPI schema for Bedrock Agent Action Groups from Lambda functions
+4. **GenerateBedrockAgentSchema**: Generate OpenAPI schema for Bedrock Agent Action Groups from Lambda functions
 5. **GetAwsSolutionsConstructPattern**: Search and discover AWS Solutions Constructs patterns
 6. **SearchGenAICDKConstructs**: Search for GenAI CDK constructs by name or type
 

awslabs/cdk_mcp_server/static/__init__.py

@@ -1,3 +1,13 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+# with the License. A copy of the License is located at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+# and limitations under the License.
 from importlib import resources
 
 

awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/actiongroups.md

@@ -32,7 +32,7 @@ For Action Groups, use the built-in OpenAPI schema generation tool provided by t
 // Using MCP client
 const result = await use_mcp_tool({
   server_name: "awslabs.cdk-mcp-server",
-  tool_name: "GenerateBedrockAgentSchemaFromFile",
+  tool_name: "GenerateBedrockAgentSchema",
   arguments: {
     lambda_code_path: "path/to/your/lambda.py",
     output_path: "path/to/output/openapi.json"

awslabs/cdk_mcp_server/static/lambda_powertools/bedrock.md

@@ -53,7 +53,7 @@ To generate a Bedrock-compatible OpenAPI schema:
 # Generate schema from a file
 result = await use_mcp_tool(
     server_name="awslabs.cdk-mcp-server",
-    tool_name="GenerateBedrockAgentSchemaFromFile",
+    tool_name="GenerateBedrockAgentSchema",
     arguments={
         "lambda_code_path": "/path/to/your/agent_actions.py",
         "output_path": "/path/to/output/schema.json"

{awslabs_cdk_mcp_server-0.0.62303.dist-info → awslabs_cdk_mcp_server-0.0.81004.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cdk-mcp-server
-Version: 0.0.62303
+Version: 0.0.81004
 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
@@ -41,10 +41,79 @@ MCP server for AWS Cloud Development Kit (CDK) best practices, infrastructure as
 
 ### Amazon Bedrock Agent Schema Generation
 
-- Generate OpenAPI schema for Bedrock Agent Action Groups
+- Use this tool when creating Bedrock Agents with Action Groups that use Lambda functions
 - Streamline the creation of Bedrock Agent schemas
 - Convert code files to compatible OpenAPI specifications
 
+#### Developer Notes
+
+- **Requirements**: Your Lambda function must use `BedrockAgentResolver` from AWS Lambda Powertools
+- **Lambda Dependencies**: If schema generation fails, a fallback script will be generated. If you see error messages about missing dependencies, install them and then run the script again.
+- **Integration**: Use the generated schema with `bedrock.ApiSchema.fromLocalAsset()` in your CDK code
+
+## CDK Implementation Workflow
+
+This diagram provides a comprehensive view of the recommended CDK implementation workflow:
+
+```mermaid
+graph TD
+    Start([Start]) --> Init["cdk init app"]
+    
+    Init --> B{Choose Approach}
+    B -->|"Common Patterns"| C1["GetAwsSolutionsConstructPattern"]
+    B -->|"GenAI Features"| C2["SearchGenAICDKConstructs"]
+    B -->|"Custom Needs"| C3["Custom CDK Code"]
+    
+    C1 --> D1["Implement Solutions Construct"]
+    C2 --> D2["Implement GenAI Constructs"]
+    C3 --> D3["Implement Custom Resources"]
+    
+    %% Bedrock Agent with Action Groups specific flow
+    D2 -->|"For Bedrock Agents<br/>with Action Groups"| BA["Create Lambda with<br/>BedrockAgentResolver"]
+    
+    %% Schema generation flow
+    BA --> BS["GenerateBedrockAgentSchema"]
+    BS -->|"Success"| JSON["openapi.json created"]
+    BS -->|"Import Errors"| BSF["Tool generates<br/>generate_schema.py"]
+    BSF -->|"Missing dependencies?"| InstallDeps["Install dependencies"]
+    InstallDeps --> BSR["Run script manually:<br/>python generate_schema.py"]
+    BSR --> JSON["openapi.json created"]
+    
+    %% Use schema in Agent CDK
+    JSON --> AgentCDK["Use schema in<br/>Agent CDK code"]
+    AgentCDK --> D2
+    
+    %% Conditional Lambda Powertools implementation
+    D1 & D2 & D3 --> HasLambda{"Using Lambda<br/>Functions?"}
+    HasLambda -->|"Yes"| L["Add Lambda Powertools<br/>and create Layer"]
+    HasLambda -->|"No"| SkipL["Skip Lambda<br/>Powertools"]
+    
+    %% Rest of workflow
+    L --> Synth["cdk synth"]
+    SkipL --> Synth
+    
+    Synth --> Nag{"CDK Nag<br/>warnings?"}
+    Nag -->|Yes| E["ExplainCDKNagRule"]
+    Nag -->|No| Deploy["cdk deploy"]
+    
+    E --> Fix["Fix or Add Suppressions"]
+    Fix --> CN["CheckCDKNagSuppressions"]
+    CN --> Synth
+    
+    %% Styling with darker colors
+    classDef default fill:#424242,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef cmd fill:#4a148c,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef tool fill:#01579b,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef note fill:#1b5e20,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef output fill:#006064,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    classDef decision fill:#5d4037,stroke:#ffffff,stroke-width:1px,color:#ffffff;
+    
+    class Init,Synth,Deploy,BSR cmd;
+    class C1,C2,BS,E,CN tool;
+    class JSON output;
+    class HasLambda,Nag decision;
+```
+
 ## Tools and Resources
 
 - **CDK Nag Rules**: Access rule packs via `cdk-nag://rules/{rule_pack}`

awslabs_cdk_mcp_server-0.0.81004.dist-info/RECORD

@@ -0,0 +1,51 @@
+awslabs/__init__.py,sha256=CyFUCiG6C9srM7h_p6i9w72Y_G53m4QN-jK0duBu948,558
+awslabs/cdk_mcp_server/__init__.py,sha256=tE_wgU3b_iQUzMy9HlAJUehazMBzM9hGM94kDKPEDq4,748
+awslabs/cdk_mcp_server/server.py,sha256=Mom-3sv93jLG-KdESEfbrIEo3isXdAMhHcyTxANFtBw,693
+awslabs/cdk_mcp_server/core/__init__.py,sha256=P5jMlOb_nAqCEM22QnIe9RZMUCLVHwmAnwqJInvcQfc,605
+awslabs/cdk_mcp_server/core/resources.py,sha256=DBIgjzhBorbjtDp-qRxq16oGnK39KHtZlKlUXXhKKC4,10152
+awslabs/cdk_mcp_server/core/search_utils.py,sha256=GLaNJBFzmDgwM8OY98R4VHfgj2Cw7GEBk-Y2lLZcPjM,6144
+awslabs/cdk_mcp_server/core/server.py,sha256=FmEb02_yu8kjr7PL-8fZ51Tu7ywl8kbMsxWMjrhvRlY,3145
+awslabs/cdk_mcp_server/core/tools.py,sha256=m_GkmypslKBbhOA8VcDQmXRhwaLUi9BvSi0OO0zqINs,19279
+awslabs/cdk_mcp_server/data/__init__.py,sha256=8o7-TnXbiVvfwc_xc6LGnDfERnD9GMPRFfnWcgf--0Y,605
+awslabs/cdk_mcp_server/data/cdk_nag_parser.py,sha256=c_gIWGvn9zQzyfr-U-uBWR5b4n68PjSDNSj8c8AH370,11459
+awslabs/cdk_mcp_server/data/construct_descriptions.py,sha256=CBfKFM_pJo6Sn_NA7hr-0oVB8piXdncQ_A5ewnTCx30,3164
+awslabs/cdk_mcp_server/data/genai_cdk_loader.py,sha256=wARJk0pH8_3_ic2t9sa7zV8djQVOp_iNRUJw1hJxCIg,16066
+awslabs/cdk_mcp_server/data/lambda_powertools_loader.py,sha256=5Wk0mLyakthzazGteGTCmk4uGOdmZfzHrNCfKGhrzVQ,2393
+awslabs/cdk_mcp_server/data/schema_generator.py,sha256=p2RGeitGt82blWsO3LEQdleYGxfkTZIOjlUaV5CsqPM,29107
+awslabs/cdk_mcp_server/data/solutions_constructs_parser.py,sha256=ceIZwKlj_zdxC1Z17NZ2FKCeVFwNZCoj7GwTjDlC_Q4,28215
+awslabs/cdk_mcp_server/static/CDK_GENERAL_GUIDANCE.md,sha256=aFUZvhfELhS7UEffFIzJM-tRS8a7Aj13X9O7FnGN0UI,12245
+awslabs/cdk_mcp_server/static/CDK_NAG_GUIDANCE.md,sha256=zJtHJp9ruaaJ-xa68k9kDrPmEaXpiWCZZf7JIy8NK0w,5839
+awslabs/cdk_mcp_server/static/__init__.py,sha256=6MiRoh0eFS7TU_pj09tFRjWROSG2nYkMXLcWMdm5WAs,752
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/bedrockguardrails.md,sha256=CX00B7XgDpLbVxvf6B-a13O4NERAJMiaPPeTuKK-8Sw,7386
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/profiles.md,sha256=xxPnEkZ0tJAFKomMuAPLm3EtlQFku6MR2nPu4VoyppE,7195
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/actiongroups.md,sha256=m40RkxPkX3BI4PHEBQHHPOAAK0rgdPkLVi37F3JcLZQ,4857
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/alias.md,sha256=eyTmjmHyQbuR5CbFpp2qrEcEqw2l9pMupWERRVksVNw,1293
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/collaboration.md,sha256=nNu30F5ydUbb7HtboUWNhp0hOnQMw8q8shCUjMDwT_A,3616
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/creation.md,sha256=BzpVJkRs_q1ZkW8LnIEh7--57OnNmHHdPCygfGJAks0,6216
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/custom_orchestration.md,sha256=ylMTq3PT3vHnrul_boLuQIGQFuk_Y0evdImp_pLY7rY,2983
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/overview.md,sha256=4FLhC3CC01W9Gpw4S0Z6yWPnM86p2nJ_dxQ1yU4Xsxw,2921
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/prompt_override.md,sha256=ypmKxlO5WIYqUh2gYDzo1Mwzso_HwSkzrMHeDU473C8,2520
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/chunking.md,sha256=TpLXPJso6c4MhWUepX0WsX3FE6FOIsFBPcE28B-3iKM,3203
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/datasources.md,sha256=iHQ086zHzkqHoKLi7pmyMxf0oH02UVHf_GAid6EMdeE,7147
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/kendra.md,sha256=sYbhIAaGjuJ2lifP0xvDXacDEVFC24Gl9giAI6RF9bo,2786
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/overview.md,sha256=AGLS6146UufRTC80EAyAviBhAtb7hFcbMz3tWFviPOc,5167
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/parsing.md,sha256=AQ6TTO5HxKqhtVdv1bM6GjHyDgOICaNi5NtDT9Dxp10,1155
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/transformation.md,sha256=I5Lkn0giUr5n0lTxqjtUsoHNkom6AJtxEnvlarH_54Y,813
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/vector/aurora.md,sha256=CjiJDoaui2H4-nu99Sem4rK_8pQGB_ciI5So5pKWMSQ,5766
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/vector/creation.md,sha256=jXxrwnor7_YUJc9sYCHjrQnCnHQrVItPI7YttcX-mX8,4491
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/vector/opensearch.md,sha256=mM8nILHaFaLfHUaIl7c8Eh0NFx8Z5H4yu5LbC-DmnSU,1368
+awslabs/cdk_mcp_server/static/genai_cdk/bedrock/knowledgebases/vector/pinecone.md,sha256=OnKjSXB6CHBxnXJFGbsIRqpLyA6_S2AiHOJslxQVaOw,2053
+awslabs/cdk_mcp_server/static/genai_cdk/opensearch-vectorindex/overview.md,sha256=0aSuBwX4ubI5WqwEfrnX1MH2UJlJOzdXZQ003fRIrGM,4121
+awslabs/cdk_mcp_server/static/genai_cdk/opensearchserverless/overview.md,sha256=aUO1BRana_xqUPENP3GQyOSCAvV9mI-ZWls7x0g8ruA,746
+awslabs/cdk_mcp_server/static/lambda_powertools/bedrock.md,sha256=iqmnsoOQlXHOwsvF9U5quIclIBQvv4mEf2TGFnZI_SA,4284
+awslabs/cdk_mcp_server/static/lambda_powertools/cdk.md,sha256=XBj-31YcphHb1BjCYz4nRpAfPuVJVRmDYI2K7e6Ti8E,3826
+awslabs/cdk_mcp_server/static/lambda_powertools/dependencies.md,sha256=nZ2Fv54rG1rUmD_YHkM9h5VNvB81-Hk8Qx3ZNQSFZLY,1520
+awslabs/cdk_mcp_server/static/lambda_powertools/index.md,sha256=yivjInZAZ3tENKGrrAv7geICzUvKUTskWuaNj9nuPbI,1819
+awslabs/cdk_mcp_server/static/lambda_powertools/insights.md,sha256=t-lgyx2AstqXuY7LeWyhQxknrPN27-nAcwW-GTjI058,3445
+awslabs/cdk_mcp_server/static/lambda_powertools/logging.md,sha256=6CSgD8QB3Bs4s_x4RnbKwZoWvG6aG4etCnmDH6HU9XY,1797
+awslabs/cdk_mcp_server/static/lambda_powertools/metrics.md,sha256=XpQHtNSQRKN3GUqQWkk1lTfQSRC0LmW6VoX1dlwEvnQ,3182
+awslabs/cdk_mcp_server/static/lambda_powertools/tracing.md,sha256=Q3dSCvgktb9sUsuuQ5ONU2Qdb1OTwbNOYpK--MDzBNw,2539
+awslabs_cdk_mcp_server-0.0.81004.dist-info/METADATA,sha256=mBHvzTFHyb40gc_0tpKlU9TuypMrG_CVtAiHY_cKneo,6508
+awslabs_cdk_mcp_server-0.0.81004.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_cdk_mcp_server-0.0.81004.dist-info/entry_points.txt,sha256=LertzmID_mUU1YYZPySAF1IY1zE7ySTvzFxiGyo3VjY,78
+awslabs_cdk_mcp_server-0.0.81004.dist-info/RECORD,,

awslabs/cdk_mcp_server/static/bedrock/agent/actiongroups.md

@@ -1,137 +0,0 @@
-# Action Groups
-
-## Overview
-
-Action groups define functions your agent can call, connecting Bedrock Agents to your business logic via Lambda functions. The agent uses an OpenAPI schema to understand what your functions do and how to call them.
-
-```mermaid
-graph LR
-    A[Agent] --> B[Action Group]
-    B --> C[Lambda Function]
-    B --> D[OpenAPI Schema]
-```
-
-## Action Group Properties
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | Yes | The name of the action group |
-| description | string | No | A description of the action group |
-| apiSchema | ApiSchema | No | The API Schema |
-| executor | ActionGroupExecutor | No | The action group executor |
-| enabled | boolean | No | Specifies whether the action group is available for the agent to invoke or not when sending an InvokeAgent request. Defaults to true |
-| forceDelete | boolean | No | Specifies whether to delete the resource even if it's in use. Defaults to false |
-| functionSchema | CfnAgent.FunctionSchemaProperty | No | Defines functions that each define parameters that the agent needs to invoke from the user |
-| parentActionGroupSignature | ParentActionGroupSignature | No | The AWS Defined signature for enabling certain capabilities in your agent. When specified, description, apiSchema, and actionGroupExecutor must be blank |
-
-## OpenAPI Schema Generation & Best Practices
-
-For Action Groups, use the built-in OpenAPI schema generation tool provided by the AWS CDK MCP server:
-
-```typescript
-// Using MCP client
-const result = await use_mcp_tool({
-  server_name: "awslabs.cdk-mcp-server",
-  tool_name: "GenerateBedrockAgentSchemaFromFile",
-  arguments: {
-    lambda_code_path: "path/to/your/lambda.py",
-    output_path: "path/to/output/openapi.json"
-  }
-});
-```
-
-The tool will:
-
-1. Parse your Lambda function code
-2. Extract function signatures and docstrings
-3. Generate a Bedrock-compatible OpenAPI schema
-4. Save it to the specified output path
-
-### Key Requirements
-- Ensure each operation has a unique operationId
-- Define complete response schemas
-- Use `fromLocalAsset` (not `fromAsset`) for API schemas
-- Include detailed descriptions for all endpoints, parameters, and return values
-- Use proper type annotations with Python type hints
-
-### Lambda Function Example
-
-```python
-from aws_lambda_powertools.event_handler import BedrockAgentResolver
-from typing import Annotated, List
-from aws_lambda_powertools.event_handler.openapi.params import Query, Path
-from pydantic import BaseModel, Field
-
-app = BedrockAgentResolver()
-
-class Product(BaseModel):
-    product_id: str = Field(description="Unique product identifier")
-    name: str = Field(description="Product name")
-    price: float = Field(description="Product price in USD")
-
-@app.get("/products", description="List available products")
-def list_products(
-    category: Annotated[str, Query(description="Product category")] = None
-) -> List[Product]:
-    # Your business logic here
-    return [Product(product_id="1", name="Product A", price=19.99)]
-
-def lambda_handler(event, context):
-    return app.resolve(event, context)
-```
-
-## Examples
-
-### TypeScript
-
-```ts
-const actionGroupFunction = new lambda_python.PythonFunction(this, 'ActionGroupFunction', {
-  runtime: lambda.Runtime.PYTHON_3_12,
-  entry: path.join(__dirname, '../lambda/action-group'),
-});
-
-// Example of proper Action Group setup with fromLocalAsset
-const actionGroup = new AgentActionGroup({
-  name: 'query-library',
-  description: 'Use these functions to get information about the books in the library.',
-  executor: bedrock.ActionGroupExecutor.fromlambdaFunction(actionGroupFunction),
-  enabled: true,
-  apiSchema: bedrock.ApiSchema.fromLocalAsset(path.join(__dirname, 'action-group.yaml')),
-});
-
-agent.addActionGroup(actionGroup);
-
-// Real-world example with account actions
-const agentAccountActions = new AgentActionGroup({
-  name: "agent-account-actions",
-  description: "Use these functions to take actions on authenticated user's accounts",
-  executor: bedrock.ActionGroupExecutor.fromlambdaFunction(accountActionsLambda),
-  apiSchema: bedrock.ApiSchema.fromLocalAsset(
-    path.join(agentsLambdaDir, "account_actions", "openapi.json"),
-  ),
-});
-
-agent.addActionGroup(agentAccountActions);
-```
-
-### Python
-
-```python
-action_group_function = PythonFunction(
-            self,
-            "LambdaFunction",
-            runtime=Runtime.PYTHON_3_12,
-            entry="./lambda",
-            index="app.py",
-            handler="lambda_handler",
-)
-
-actionGroup = bedrock.AgentActionGroup(
-    name="query-library",
-    description="Use these functions to get information about the books in the library.",
-    executor= bedrock.ActionGroupExecutor.fromlambda_function(action_group_function),
-    enabled=True,
-    api_schema=bedrock.ApiSchema.from_local_asset("action-group.yaml"))
-
-agent.add_action_group(actionGroup)
-```

awslabs/cdk_mcp_server/static/bedrock/agent/alias.md

@@ -1,39 +0,0 @@
-# Agent Alias
-
-## Overview
-
-After you have sufficiently iterated on your working draft and are satisfied with the behavior of your agent, you can set it up for deployment and integration into your application by creating aliases of your agent.
-
-To deploy your agent, you need to create an alias. During alias creation, Amazon Bedrock automatically creates a version of your agent. The alias points to this newly created version. You can point the alias to a previously created version if necessary. You then configure your application to make API calls to that alias.
-
-By default, the `Agent` resource does not create any aliases, and you can use the 'DRAFT' version.
-
-## Specific Version
-
-You can use the `AgentAlias` resource if you want to create an Alias for an existing Agent.
-
-## Example
-
-### TypeScript
-
-```ts
-const agentAlias2 = new bedrock.AgentAlias(this, 'myalias2', {
-  aliasName: 'myalias',
-  agent: agent,
-  agentVersion: '1', // optional
-  description: 'mytest'
-});
-```
-
-### Python
-
-```python
-agent_alias_2 = bedrock.AgentAlias(self, 'myalias2',
-    alias_name='myalias',
-    agent=agent,
-    agent_version='1', # optional
-    description='mytest'
-)
-```
-
-[View full documentation](https://github.com/awslabs/generative-ai-cdk-constructs/blob/main/src/cdk-lib/bedrock/README.md)

awslabs/cdk_mcp_server/static/bedrock/agent/collaboration.md

@@ -1,91 +0,0 @@
-# Agent Collaboration
-
-## Overview
-
-Agent Collaboration enables multiple Bedrock Agents to work together on complex tasks. This feature allows agents to specialize in different areas and collaborate to provide more comprehensive responses to user queries.
-
-## Collaboration Types
-
-You can configure collaboration for an agent using the `agentCollaboration` and `agentCollaborators` properties in the `AgentProps` interface.
-
-- **SUPERVISOR**: The agent acts as a supervisor that can delegate tasks to other agents.
-- **SUPERVISOR_ROUTER**: The agent acts as a supervisor that can route requests to specialized agents.
-- **DISABLED**: Collaboration is disabled (default).
-
-## Example
-
-### TypeScript
-
-```typescript
-import { Agent, AgentCollaboratorType, RelayConversationHistoryType } from '@cdklabs/generative-ai-cdk-constructs';
-
-// Create a specialized agent for customer support
-const customerSupportAgent = new Agent(this, 'CustomerSupportAgent', {
-  name: 'CustomerSupportAgent',
-  instruction: 'You specialize in answering customer support questions about our products.',
-  foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
-});
-
-// Create an agent alias for the specialized agent
-const customerSupportAlias = new AgentAlias(this, 'CustomerSupportAlias', {
-  agent: customerSupportAgent,
-  aliasName: 'production',
-});
-
-// Create a main agent that can collaborate with the specialized agent
-const mainAgent = new Agent(this, 'MainAgent', {
-  name: 'MainAgent',
-  instruction: 'You are a helpful assistant that can answer general questions and route specialized customer support questions to the customer support agent.',
-  foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
-  agentCollaboration: AgentCollaboratorType.SUPERVISOR,
-  agentCollaborators: [
-    new bedrock.AgentCollaborator({
-      agentAlias: customerSupportAlias,
-      collaborationInstruction: 'Route customer support questions to this agent.',
-      collaboratorName: 'CustomerSupport',
-      relayConversationHistory: true,
-    }),
-  ],
-});
-```
-
-### Python
-
-```python
-from cdklabs.generative_ai_cdk_constructs import (
-    bedrock,
-    AgentCollaboratorType,
-    RelayConversationHistoryType
-)
-
-# Create a specialized agent for customer support
-customer_support_agent = bedrock.Agent(self, 'CustomerSupportAgent',
-    name='CustomerSupportAgent',
-    instruction='You specialize in answering customer support questions about our products.',
-    foundation_model=bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
-)
-
-# Create an agent alias for the specialized agent
-customer_support_alias = bedrock.AgentAlias(self, 'CustomerSupportAlias',
-    agent=customer_support_agent,
-    alias_name='production',
-)
-
-# Create a main agent that can collaborate with the specialized agent
-main_agent = bedrock.Agent(self, 'MainAgent',
-    name='MainAgent',
-    instruction='You are a helpful assistant that can answer general questions and route specialized customer support questions to the customer support agent.',
-    foundation_model=bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
-    agent_collaboration=AgentCollaboratorType.SUPERVISOR,
-    agent_collaborators=[
-      bedrock.AgentCollaborator(
-        agent_alias= customer_support_alias,
-        collaboration_instruction= 'Route customer support questions to this agent.',
-        collaborator_name= 'CustomerSupport',
-        relay_conversation_history= true,
-      )
-    ],
-)
-```
-
-For more information on agent collaboration, refer to the [AWS Bedrock documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-collaboration.html).