This is page 375 of 384. Use http://codebase.md/awslabs/mcp?lines=false&page={x} to view the full context.
# Directory Structure
```
├── .devcontainer
│ └── devcontainer.json
├── .github
│ ├── actions
│ │ ├── build-and-push-container-image
│ │ │ └── action.yml
│ │ └── clear-space-ubuntu-latest-agressively
│ │ └── action.yml
│ ├── codecov.yml
│ ├── CODEOWNERS
│ ├── dependabot.yml
│ ├── ISSUE_TEMPLATE
│ │ ├── bug_report.yml
│ │ ├── documentation.yml
│ │ ├── feature_request.yml
│ │ ├── rfc.yml
│ │ └── support_awslabs_mcp_servers.yml
│ ├── pull_request_template.md
│ ├── SECURITY
│ ├── SUPPORT
│ └── workflows
│ ├── aws-api-mcp-upgrade-version.yml
│ ├── bandit-requirements.txt
│ ├── bandit.yml
│ ├── cfn_nag.yml
│ ├── check-gh-pages-builds.yml
│ ├── check-license-header-hash.txt
│ ├── check-license-header.json
│ ├── check-license-header.yml
│ ├── checkov.yml
│ ├── codeql.yml
│ ├── dependency-review-action.yml
│ ├── detect-secrets-requirements.txt
│ ├── gh-pages.yml
│ ├── merge-prevention.yml
│ ├── powershell.yml
│ ├── pre-commit-requirements.txt
│ ├── pre-commit.yml
│ ├── pull-request-lint.yml
│ ├── python.yml
│ ├── RELEASE_INSTRUCTIONS.md
│ ├── release-initiate-branch.yml
│ ├── release-merge-tag.yml
│ ├── release.py
│ ├── release.yml
│ ├── scanners.yml
│ ├── scorecard-analysis.yml
│ ├── semgrep-requirements.txt
│ ├── semgrep.yml
│ ├── stale.yml
│ ├── trivy.yml
│ └── typescript.yml
├── .gitignore
├── .pre-commit-config.yaml
├── .python-version
├── .ruff.toml
├── .secrets.baseline
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── DESIGN_GUIDELINES.md
├── DEVELOPER_GUIDE.md
├── docs
│ └── images
│ └── root-readme
│ ├── cline-api-provider-filled.png
│ ├── cline-chat-interface.png
│ ├── cline-custom-instructions.png
│ ├── cline-select-aws-profile.png
│ ├── cline-select-bedrock.png
│ ├── configure-mcp-servers.png
│ ├── install-cline-extension.png
│ ├── mcp-servers-installed.png
│ └── select-mcp-servers.png
├── docusaurus
│ ├── .gitignore
│ ├── docs
│ │ ├── installation.md
│ │ ├── intro.md
│ │ ├── samples
│ │ │ ├── index.md
│ │ │ ├── mcp-integration-with-kb.md
│ │ │ ├── mcp-integration-with-nova-canvas.md
│ │ │ └── stepfunctions-tool-mcp-server.md
│ │ ├── servers
│ │ │ ├── amazon-bedrock-agentcore-mcp-server.md
│ │ │ ├── amazon-keyspaces-mcp-server.md
│ │ │ ├── amazon-mq-mcp-server.md
│ │ │ ├── amazon-neptune-mcp-server.md
│ │ │ ├── amazon-qbusiness-anonymous-mcp-server.md
│ │ │ ├── amazon-qindex-mcp-server.md
│ │ │ ├── amazon-sns-sqs-mcp-server.md
│ │ │ ├── aurora-dsql-mcp-server.md
│ │ │ ├── aws-api-mcp-server.md
│ │ │ ├── aws-appsync-mcp-server.md
│ │ │ ├── aws-bedrock-custom-model-import-mcp-server.md
│ │ │ ├── aws-bedrock-data-automation-mcp-server.md
│ │ │ ├── aws-dataprocessing-mcp-server.md
│ │ │ ├── aws-diagram-mcp-server.md
│ │ │ ├── aws-documentation-mcp-server.md
│ │ │ ├── aws-healthomics-mcp-server.md
│ │ │ ├── aws-iot-sitewise-mcp-server.md
│ │ │ ├── aws-knowledge-mcp-server.md
│ │ │ ├── aws-location-mcp-server.md
│ │ │ ├── aws-msk-mcp-server.md
│ │ │ ├── aws-pricing-mcp-server.md
│ │ │ ├── aws-serverless-mcp-server.md
│ │ │ ├── aws-support-mcp-server.md
│ │ │ ├── bedrock-kb-retrieval-mcp-server.md
│ │ │ ├── billing-cost-management-mcp-server.md
│ │ │ ├── ccapi-mcp-server.md
│ │ │ ├── cdk-mcp-server.md
│ │ │ ├── cfn-mcp-server.md
│ │ │ ├── cloudtrail-mcp-server.md
│ │ │ ├── cloudwatch-appsignals-mcp-server.md
│ │ │ ├── cloudwatch-mcp-server.md
│ │ │ ├── code-doc-gen-mcp-server.md
│ │ │ ├── core-mcp-server.md
│ │ │ ├── cost-explorer-mcp-server.md
│ │ │ ├── documentdb-mcp-server.md
│ │ │ ├── dynamodb-mcp-server.md
│ │ │ ├── ecs-mcp-server.md
│ │ │ ├── eks-mcp-server.md
│ │ │ ├── elasticache-mcp-server.md
│ │ │ ├── finch-mcp-server.md
│ │ │ ├── frontend-mcp-server.md
│ │ │ ├── git-repo-research-mcp-server.md
│ │ │ ├── healthlake-mcp-server.md
│ │ │ ├── iam-mcp-server.md
│ │ │ ├── kendra-index-mcp-server.md
│ │ │ ├── lambda-tool-mcp-server.md
│ │ │ ├── memcached-mcp-server.md
│ │ │ ├── mysql-mcp-server.md
│ │ │ ├── nova-canvas-mcp-server.md
│ │ │ ├── openapi-mcp-server.md
│ │ │ ├── postgres-mcp-server.md
│ │ │ ├── prometheus-mcp-server.md
│ │ │ ├── redshift-mcp-server.md
│ │ │ ├── s3-tables-mcp-server.md
│ │ │ ├── stepfunctions-tool-mcp-server.md
│ │ │ ├── syntheticdata-mcp-server.md
│ │ │ ├── terraform-mcp-server.md
│ │ │ ├── timestream-for-influxdb-mcp-server.md
│ │ │ ├── valkey-mcp-server.md
│ │ │ └── well-architected-security-mcp-server.mdx
│ │ └── vibe_coding.md
│ ├── docusaurus.config.ts
│ ├── package-lock.json
│ ├── package.json
│ ├── README.md
│ ├── sidebars.ts
│ ├── src
│ │ ├── components
│ │ │ ├── HomepageFeatures
│ │ │ │ └── styles.module.css
│ │ │ └── ServerCards
│ │ │ ├── index.tsx
│ │ │ └── styles.module.css
│ │ ├── css
│ │ │ ├── custom.css
│ │ │ └── doc-override.css
│ │ └── pages
│ │ ├── index.module.css
│ │ └── servers.tsx
│ ├── static
│ │ ├── .nojekyll
│ │ ├── assets
│ │ │ ├── icons
│ │ │ │ ├── activity.svg
│ │ │ │ ├── book-open.svg
│ │ │ │ ├── cpu.svg
│ │ │ │ ├── database.svg
│ │ │ │ ├── dollar-sign.svg
│ │ │ │ ├── help-circle.svg
│ │ │ │ ├── key.svg
│ │ │ │ ├── server.svg
│ │ │ │ ├── share-2.svg
│ │ │ │ ├── tool.svg
│ │ │ │ └── zap.svg
│ │ │ └── server-cards.json
│ │ └── img
│ │ ├── aws-logo.svg
│ │ └── logo.png
│ └── tsconfig.json
├── LICENSE
├── NOTICE
├── README.md
├── samples
│ ├── mcp-integration-with-kb
│ │ ├── .env.example
│ │ ├── .python-version
│ │ ├── assets
│ │ │ └── simplified-mcp-flow-diagram.png
│ │ ├── clients
│ │ │ └── client_server.py
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── user_interfaces
│ │ │ └── chat_bedrock_st.py
│ │ └── uv.lock
│ ├── mcp-integration-with-nova-canvas
│ │ ├── .env.example
│ │ ├── .python-version
│ │ ├── clients
│ │ │ └── client_server.py
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── user_interfaces
│ │ │ └── image_generator_st.py
│ │ └── uv.lock
│ ├── README.md
│ └── stepfunctions-tool-mcp-server
│ ├── README.md
│ └── sample_state_machines
│ ├── customer-create
│ │ └── app.py
│ ├── customer-id-from-email
│ │ └── app.py
│ ├── customer-info-from-id
│ │ └── app.py
│ └── template.yml
├── src
│ ├── amazon-bedrock-agentcore-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_bedrock_agentcore_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── config.py
│ │ │ ├── server.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── cache.py
│ │ │ ├── doc_fetcher.py
│ │ │ ├── indexer.py
│ │ │ ├── text_processor.py
│ │ │ └── url_validator.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── SECURITY.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_cache.py
│ │ │ ├── test_config.py
│ │ │ ├── test_doc_fetcher.py
│ │ │ ├── test_indexer.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_server.py
│ │ │ ├── test_text_processor.py
│ │ │ └── test_url_validator.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── amazon-kendra-index-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_kendra_index_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── server.py
│ │ │ └── util.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── amazon-keyspaces-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_keyspaces_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── client.py
│ │ │ ├── config.py
│ │ │ ├── consts.py
│ │ │ ├── llm_context.py
│ │ │ ├── models.py
│ │ │ ├── server.py
│ │ │ └── services.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── test_client.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_query_analysis_service.py
│ │ │ ├── test_server.py
│ │ │ └── test_services.py
│ │ └── uv.lock
│ ├── amazon-mq-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_mq_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── aws_service_mcp_generator.py
│ │ │ ├── consts.py
│ │ │ ├── rabbitmq
│ │ │ │ ├── __init__.py
│ │ │ │ ├── admin.py
│ │ │ │ ├── connection.py
│ │ │ │ ├── doc
│ │ │ │ │ ├── rabbitmq_broker_sizing_guide.md
│ │ │ │ │ ├── rabbitmq_performance_optimization_best_practice.md
│ │ │ │ │ ├── rabbitmq_production_deployment_guidelines.md
│ │ │ │ │ ├── rabbitmq_quorum_queue_migration_guide.md
│ │ │ │ │ └── rabbitmq_setup_best_practice.md
│ │ │ │ ├── handlers.py
│ │ │ │ └── module.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── example
│ │ │ └── sample_mcp_q_cli.json
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── rabbitmq
│ │ │ │ ├── __init__.py
│ │ │ │ ├── conftest.py
│ │ │ │ ├── test_admin.py
│ │ │ │ ├── test_connection.py
│ │ │ │ ├── test_handlers.py
│ │ │ │ └── test_module.py
│ │ │ ├── test_aws_service_mcp_generator.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── amazon-neptune-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_neptune_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── exceptions.py
│ │ │ ├── graph_store
│ │ │ │ ├── __init__.py
│ │ │ │ ├── analytics.py
│ │ │ │ ├── base.py
│ │ │ │ └── database.py
│ │ │ ├── models.py
│ │ │ ├── neptune.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_analytics.py
│ │ │ ├── test_database.py
│ │ │ ├── test_exceptions.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_models.py
│ │ │ ├── test_neptune.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── amazon-qbusiness-anonymous-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_qbusiness_anonymous_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── clients.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── amazon-qindex-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_qindex_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── clients.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_clients.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── test_server.py
│ │ └── uv.lock
│ ├── amazon-sns-sqs-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── amazon_sns_sqs_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── common.py
│ │ │ ├── consts.py
│ │ │ ├── generator.py
│ │ │ ├── server.py
│ │ │ ├── sns.py
│ │ │ └── sqs.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── print_tools.py
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── README.md
│ │ │ ├── test_common.py
│ │ │ ├── test_generator.py
│ │ │ ├── test_server.py
│ │ │ ├── test_sns.py
│ │ │ └── test_sqs.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aurora-dsql-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aurora_dsql_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── consts.py
│ │ │ ├── mutable_sql_detector.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_connection_reuse.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_profile_option.py
│ │ │ ├── test_readonly_enforcement.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-api-mcp-server
│ │ ├── .gitattributes
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_api_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── core
│ │ │ │ ├── __init__.py
│ │ │ │ ├── agent_scripts
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── manager.py
│ │ │ │ │ ├── models.py
│ │ │ │ │ └── registry
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── application-failure-troubleshooting.script.md
│ │ │ │ │ ├── cloudtral-mutli-region-setup.script.md
│ │ │ │ │ ├── create_amazon_aurora_db_cluster_with_instances.script.md
│ │ │ │ │ ├── lambda-timeout-debugging.script.md
│ │ │ │ │ ├── scripts_format.md
│ │ │ │ │ └── troubleshoot-permissions-with-cloudtrail-events.script.md
│ │ │ │ ├── aws
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── driver.py
│ │ │ │ │ ├── pagination.py
│ │ │ │ │ ├── regions.py
│ │ │ │ │ ├── service.py
│ │ │ │ │ └── services.py
│ │ │ │ ├── common
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── command_metadata.py
│ │ │ │ │ ├── command.py
│ │ │ │ │ ├── config.py
│ │ │ │ │ ├── errors.py
│ │ │ │ │ ├── file_operations.py
│ │ │ │ │ ├── file_system_controls.py
│ │ │ │ │ ├── helpers.py
│ │ │ │ │ ├── models.py
│ │ │ │ │ └── py.typed
│ │ │ │ ├── data
│ │ │ │ │ └── api_metadata.json
│ │ │ │ ├── metadata
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ └── read_only_operations_list.py
│ │ │ │ ├── parser
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── custom_validators
│ │ │ │ │ │ ├── __init__.py
│ │ │ │ │ │ ├── botocore_param_validator.py
│ │ │ │ │ │ ├── ec2_validator.py
│ │ │ │ │ │ └── ssm_validator.py
│ │ │ │ │ ├── interpretation.py
│ │ │ │ │ ├── lexer.py
│ │ │ │ │ └── parser.py
│ │ │ │ ├── py.typed
│ │ │ │ └── security
│ │ │ │ ├── __init__.py
│ │ │ │ ├── aws_api_customization.json
│ │ │ │ └── policy.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── CONTRIBUTING.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── agent_scripts
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_manager.py
│ │ │ │ └── test_registry
│ │ │ │ ├── another_valid_script.script.md
│ │ │ │ ├── test_script.script.md
│ │ │ │ └── valid_script.script.md
│ │ │ ├── aws
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_driver.py
│ │ │ │ ├── test_pagination.py
│ │ │ │ ├── test_service.py
│ │ │ │ └── test_services.py
│ │ │ ├── common
│ │ │ │ ├── test_command.py
│ │ │ │ ├── test_config.py
│ │ │ │ ├── test_file_operations.py
│ │ │ │ ├── test_file_system_controls.py
│ │ │ │ ├── test_file_validation.py
│ │ │ │ └── test_helpers.py
│ │ │ ├── fixtures.py
│ │ │ ├── history_handler.py
│ │ │ ├── metadata
│ │ │ │ ├── __init__.py
│ │ │ │ └── test_read_only_operations_list.py
│ │ │ ├── parser
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_file_path_detection.py
│ │ │ │ ├── test_lexer.py
│ │ │ │ ├── test_parser_customizations.py
│ │ │ │ └── test_parser.py
│ │ │ ├── test_security_policy.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-appsync-mcp-server
│ │ ├── .dockerignore
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_appsync_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── decorators.py
│ │ │ ├── helpers.py
│ │ │ ├── operations
│ │ │ │ ├── __init__.py
│ │ │ │ ├── create_api_cache.py
│ │ │ │ ├── create_api_key.py
│ │ │ │ ├── create_api.py
│ │ │ │ ├── create_channel_namespace.py
│ │ │ │ ├── create_datasource.py
│ │ │ │ ├── create_domain_name.py
│ │ │ │ ├── create_function.py
│ │ │ │ ├── create_graphql_api.py
│ │ │ │ ├── create_resolver.py
│ │ │ │ └── create_schema.py
│ │ │ ├── server.py
│ │ │ ├── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── create_api_cache.py
│ │ │ │ ├── create_api_key.py
│ │ │ │ ├── create_api.py
│ │ │ │ ├── create_channel_namespace.py
│ │ │ │ ├── create_datasource.py
│ │ │ │ ├── create_domain_name.py
│ │ │ │ ├── create_function.py
│ │ │ │ ├── create_graphql_api.py
│ │ │ │ ├── create_resolver.py
│ │ │ │ └── create_schema.py
│ │ │ └── validators.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── test_all_create_tools_write_protection.py
│ │ │ ├── test_create_api_cache.py
│ │ │ ├── test_create_api_key.py
│ │ │ ├── test_create_api.py
│ │ │ ├── test_create_channel_namespace.py
│ │ │ ├── test_create_datasource_tool.py
│ │ │ ├── test_create_datasource.py
│ │ │ ├── test_create_domain_name.py
│ │ │ ├── test_create_function.py
│ │ │ ├── test_create_graphql_api.py
│ │ │ ├── test_create_resolver.py
│ │ │ ├── test_create_schema_tool.py
│ │ │ ├── test_create_schema.py
│ │ │ ├── test_helpers.py
│ │ │ ├── test_server.py
│ │ │ ├── test_validators.py
│ │ │ └── test_write_operation.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-bedrock-custom-model-import-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_bedrock_custom_model_import_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── client.py
│ │ │ ├── llm_context.py
│ │ │ ├── models.py
│ │ │ ├── prompts.py
│ │ │ ├── server.py
│ │ │ ├── services
│ │ │ │ ├── __init__.py
│ │ │ │ ├── imported_model_service.py
│ │ │ │ └── model_import_service.py
│ │ │ ├── tools
│ │ │ │ ├── create_model_import_job.py
│ │ │ │ ├── delete_imported_model.py
│ │ │ │ ├── get_imported_model.py
│ │ │ │ ├── get_model_import_job.py
│ │ │ │ ├── list_imported_models.py
│ │ │ │ └── list_model_import_jobs.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── aws.py
│ │ │ ├── config.py
│ │ │ ├── consts.py
│ │ │ └── matching.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── services
│ │ │ │ ├── test_imported_model_service.py
│ │ │ │ └── test_model_import_service.py
│ │ │ ├── test_client.py
│ │ │ ├── test_init.py
│ │ │ ├── test_llm_context.py
│ │ │ ├── test_prompts.py
│ │ │ ├── test_server.py
│ │ │ ├── tools
│ │ │ │ ├── test_create_model_import_job.py
│ │ │ │ ├── test_delete_imported_model.py
│ │ │ │ ├── test_get_imported_model.py
│ │ │ │ ├── test_get_model_import_job.py
│ │ │ │ ├── test_list_imported_models.py
│ │ │ │ └── test_list_model_import_jobs.py
│ │ │ └── utils
│ │ │ ├── test_aws.py
│ │ │ ├── test_config.py
│ │ │ └── test_matching.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-bedrock-data-automation-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_bedrock_data_automation_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── helpers.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── test_helpers.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-dataprocessing-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_dataprocessing_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── core
│ │ │ │ ├── __init__.py
│ │ │ │ └── glue_data_catalog
│ │ │ │ ├── __init__.py
│ │ │ │ ├── data_catalog_database_manager.py
│ │ │ │ ├── data_catalog_handler.py
│ │ │ │ └── data_catalog_table_manager.py
│ │ │ ├── handlers
│ │ │ │ ├── __init__.py
│ │ │ │ ├── athena
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── athena_data_catalog_handler.py
│ │ │ │ │ ├── athena_query_handler.py
│ │ │ │ │ └── athena_workgroup_handler.py
│ │ │ │ ├── commons
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ └── common_resource_handler.py
│ │ │ │ ├── emr
│ │ │ │ │ ├── emr_ec2_cluster_handler.py
│ │ │ │ │ ├── emr_ec2_instance_handler.py
│ │ │ │ │ └── emr_ec2_steps_handler.py
│ │ │ │ └── glue
│ │ │ │ ├── __init__.py
│ │ │ │ ├── crawler_handler.py
│ │ │ │ ├── data_catalog_handler.py
│ │ │ │ ├── glue_commons_handler.py
│ │ │ │ ├── glue_etl_handler.py
│ │ │ │ ├── interactive_sessions_handler.py
│ │ │ │ └── worklows_handler.py
│ │ │ ├── models
│ │ │ │ ├── __init__.py
│ │ │ │ ├── athena_models.py
│ │ │ │ ├── common_resource_models.py
│ │ │ │ ├── data_catalog_models.py
│ │ │ │ ├── emr_models.py
│ │ │ │ └── glue_models.py
│ │ │ ├── server.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── aws_helper.py
│ │ │ ├── consts.py
│ │ │ ├── logging_helper.py
│ │ │ └── mutable_sql_detector.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── core
│ │ │ │ ├── __init__.py
│ │ │ │ └── glue_data_catalog
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_data_catalog_database_manager.py
│ │ │ │ ├── test_data_catalog_handler.py
│ │ │ │ └── test_data_catalog_table_manager.py
│ │ │ ├── handlers
│ │ │ │ ├── __init__.py
│ │ │ │ ├── athena
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── test_athena_data_catalog_handler.py
│ │ │ │ │ ├── test_athena_query_handler.py
│ │ │ │ │ ├── test_athena_workgroup_handler.py
│ │ │ │ │ └── test_custom_tags_athena.py
│ │ │ │ ├── commons
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ └── test_common_resource_handler.py
│ │ │ │ ├── emr
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── test_custom_tags_emr.py
│ │ │ │ │ ├── test_emr_ec2_cluster_handler.py
│ │ │ │ │ ├── test_emr_ec2_instance_handler.py
│ │ │ │ │ └── test_emr_ec2_steps_handler.py
│ │ │ │ └── glue
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_crawler_handler.py
│ │ │ │ ├── test_custom_tags_glue.py
│ │ │ │ ├── test_data_catalog_handler.py
│ │ │ │ ├── test_glue_commons_handler.py
│ │ │ │ ├── test_glue_etl_handler.py
│ │ │ │ ├── test_glue_interactive_sessions_handler.py
│ │ │ │ └── test_glue_workflows_handler.py
│ │ │ ├── models
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_athena_models.py
│ │ │ │ ├── test_common_resource_models.py
│ │ │ │ ├── test_data_catalog_models.py
│ │ │ │ ├── test_emr_models.py
│ │ │ │ ├── test_glue_models.py
│ │ │ │ ├── test_interactive_sessions_models.py
│ │ │ │ └── test_workflows_models.py
│ │ │ ├── test_init.py
│ │ │ ├── test_server.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── test_aws_helper.py
│ │ │ ├── test_custom_tags.py
│ │ │ └── test_logging_helper.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-diagram-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_diagram_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── diagrams_tools.py
│ │ │ ├── models.py
│ │ │ ├── scanner.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── resources
│ │ │ │ ├── __init__.py
│ │ │ │ └── example_diagrams
│ │ │ │ ├── __init__.py
│ │ │ │ ├── aws_example.py
│ │ │ │ ├── flow_example.py
│ │ │ │ └── sequence_example.py
│ │ │ ├── test_diagrams.py
│ │ │ ├── test_models.py
│ │ │ ├── test_sarif_fix.py
│ │ │ ├── test_scanner.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-documentation-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_documentation_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── models.py
│ │ │ ├── server_aws_cn.py
│ │ │ ├── server_aws.py
│ │ │ ├── server_utils.py
│ │ │ ├── server.py
│ │ │ └── util.py
│ │ ├── basic-usage.gif
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── constants.py
│ │ │ ├── resources
│ │ │ │ └── lambda_sns_raw.html
│ │ │ ├── test_aws_cn_get_available_services_live.py
│ │ │ ├── test_aws_cn_read_documentation_live.py
│ │ │ ├── test_aws_read_documentation_live.py
│ │ │ ├── test_aws_recommend_live.py
│ │ │ ├── test_aws_search_live.py
│ │ │ ├── test_metadata_handling.py
│ │ │ ├── test_models.py
│ │ │ ├── test_server_aws_cn.py
│ │ │ ├── test_server_aws.py
│ │ │ ├── test_server_utils.py
│ │ │ ├── test_server.py
│ │ │ └── test_util.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-healthomics-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_healthomics_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── consts.py
│ │ │ ├── models.py
│ │ │ ├── server.py
│ │ │ ├── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── helper_tools.py
│ │ │ │ ├── run_analysis.py
│ │ │ │ ├── troubleshooting.py
│ │ │ │ ├── workflow_analysis.py
│ │ │ │ ├── workflow_execution.py
│ │ │ │ ├── workflow_linting.py
│ │ │ │ └── workflow_management.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── aws_utils.py
│ │ │ ├── s3_utils.py
│ │ │ └── validation_utils.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── docs
│ │ │ └── workflow_linting.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ ├── test_aws_utils.py
│ │ │ ├── test_consts.py
│ │ │ ├── test_helper_tools.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_models.py
│ │ │ ├── test_run_analysis.py
│ │ │ ├── test_s3_utils.py
│ │ │ ├── test_server.py
│ │ │ ├── test_troubleshooting.py
│ │ │ ├── test_workflow_analysis.py
│ │ │ ├── test_workflow_execution.py
│ │ │ ├── test_workflow_linting.py
│ │ │ ├── test_workflow_management.py
│ │ │ └── test_workflow_tools.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-iot-sitewise-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_iot_sitewise_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── client.py
│ │ │ ├── prompts
│ │ │ │ ├── __init__.py
│ │ │ │ ├── asset_hierarchy.py
│ │ │ │ ├── data_exploration.py
│ │ │ │ └── data_ingestion.py
│ │ │ ├── server.py
│ │ │ ├── tool_metadata.py
│ │ │ ├── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── sitewise_access.py
│ │ │ │ ├── sitewise_asset_models.py
│ │ │ │ ├── sitewise_assets.py
│ │ │ │ ├── sitewise_data.py
│ │ │ │ └── sitewise_gateways.py
│ │ │ └── validation.py
│ │ ├── CHANGELOG.md
│ │ ├── DEVELOPMENT.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── examples
│ │ │ └── wind_farm_example.py
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_server.py
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_server.py
│ │ │ ├── test_sitewise_access.py
│ │ │ ├── test_sitewise_asset_models.py
│ │ │ ├── test_sitewise_assets.py
│ │ │ ├── test_sitewise_data.py
│ │ │ ├── test_sitewise_gateways.py
│ │ │ └── test_validation.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-knowledge-mcp-server
│ │ └── README.md
│ ├── aws-location-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_location_server
│ │ │ ├── __init__.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_server_integration.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-msk-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_msk_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── server.py
│ │ │ └── tools
│ │ │ ├── __init__.py
│ │ │ ├── common_functions
│ │ │ │ ├── __init__.py
│ │ │ │ ├── client_manager.py
│ │ │ │ └── common_functions.py
│ │ │ ├── logs_and_telemetry
│ │ │ │ ├── __init__.py
│ │ │ │ ├── cluster_metrics_tools.py
│ │ │ │ ├── list_customer_iam_access.py
│ │ │ │ └── metric_config.py
│ │ │ ├── mutate_cluster
│ │ │ │ ├── __init__.py
│ │ │ │ ├── batch_associate_scram_secret.py
│ │ │ │ ├── batch_disassociate_scram_secret.py
│ │ │ │ ├── create_cluster_v2.py
│ │ │ │ ├── put_cluster_policy.py
│ │ │ │ ├── reboot_broker.py
│ │ │ │ ├── update_broker_count.py
│ │ │ │ ├── update_broker_storage.py
│ │ │ │ ├── update_broker_type.py
│ │ │ │ ├── update_cluster_configuration.py
│ │ │ │ ├── update_monitoring.py
│ │ │ │ └── update_security.py
│ │ │ ├── mutate_config
│ │ │ │ ├── __init__.py
│ │ │ │ ├── create_configuration.py
│ │ │ │ ├── tag_resource.py
│ │ │ │ ├── untag_resource.py
│ │ │ │ └── update_configuration.py
│ │ │ ├── mutate_vpc
│ │ │ │ ├── __init__.py
│ │ │ │ ├── create_vpc_connection.py
│ │ │ │ ├── delete_vpc_connection.py
│ │ │ │ └── reject_client_vpc_connection.py
│ │ │ ├── read_cluster
│ │ │ │ ├── __init__.py
│ │ │ │ ├── describe_cluster_operation.py
│ │ │ │ ├── describe_cluster.py
│ │ │ │ ├── get_bootstrap_brokers.py
│ │ │ │ ├── get_cluster_policy.py
│ │ │ │ ├── get_compatible_kafka_versions.py
│ │ │ │ ├── list_client_vpc_connections.py
│ │ │ │ ├── list_cluster_operations.py
│ │ │ │ ├── list_nodes.py
│ │ │ │ └── list_scram_secrets.py
│ │ │ ├── read_config
│ │ │ │ ├── __init__.py
│ │ │ │ ├── describe_configuration_revision.py
│ │ │ │ ├── describe_configuration.py
│ │ │ │ ├── list_configuration_revisions.py
│ │ │ │ └── list_tags_for_resource.py
│ │ │ ├── read_global
│ │ │ │ ├── __init__.py
│ │ │ │ ├── list_clusters.py
│ │ │ │ ├── list_configurations.py
│ │ │ │ ├── list_kafka_versions.py
│ │ │ │ └── list_vpc_connections.py
│ │ │ ├── read_vpc
│ │ │ │ ├── __init__.py
│ │ │ │ └── describe_vpc_connection.py
│ │ │ └── static_tools
│ │ │ ├── __init__.py
│ │ │ └── cluster_best_practices.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_client_manager.py
│ │ │ ├── test_cluster_metrics_tools.py
│ │ │ ├── test_common_functions.py
│ │ │ ├── test_create_cluster_v2.py
│ │ │ ├── test_create_configuration.py
│ │ │ ├── test_create_vpc_connection.py
│ │ │ ├── test_delete_vpc_connection.py
│ │ │ ├── test_describe_cluster_operation.py
│ │ │ ├── test_describe_cluster.py
│ │ │ ├── test_describe_configuration_revision.py
│ │ │ ├── test_describe_configuration.py
│ │ │ ├── test_describe_vpc_connection.py
│ │ │ ├── test_get_bootstrap_brokers.py
│ │ │ ├── test_get_cluster_policy.py
│ │ │ ├── test_get_compatible_kafka_versions.py
│ │ │ ├── test_init.py
│ │ │ ├── test_list_client_vpc_connections.py
│ │ │ ├── test_list_cluster_operations.py
│ │ │ ├── test_list_clusters.py
│ │ │ ├── test_list_configuration_revisions.py
│ │ │ ├── test_list_configurations.py
│ │ │ ├── test_list_customer_iam_access.py
│ │ │ ├── test_list_kafka_versions.py
│ │ │ ├── test_list_nodes.py
│ │ │ ├── test_list_scram_secrets.py
│ │ │ ├── test_list_tags_for_resource.py
│ │ │ ├── test_list_vpc_connections.py
│ │ │ ├── test_logs_and_telemetry.py
│ │ │ ├── test_main.py
│ │ │ ├── test_mutate_cluster_init.py
│ │ │ ├── test_mutate_cluster_success_cases.py
│ │ │ ├── test_mutate_cluster.py
│ │ │ ├── test_mutate_config_init.py
│ │ │ ├── test_mutate_vpc_init.py
│ │ │ ├── test_read_cluster_init_updated.py
│ │ │ ├── test_read_cluster_init.py
│ │ │ ├── test_read_config_init.py
│ │ │ ├── test_read_global_init.py
│ │ │ ├── test_read_vpc_init.py
│ │ │ ├── test_reject_client_vpc_connection.py
│ │ │ ├── test_server.py
│ │ │ ├── test_static_tools_init.py
│ │ │ ├── test_tag_resource.py
│ │ │ ├── test_tool_descriptions.py
│ │ │ ├── test_untag_resource.py
│ │ │ └── test_update_configuration.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-pricing-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_pricing_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── cdk_analyzer.py
│ │ │ ├── consts.py
│ │ │ ├── helpers.py
│ │ │ ├── models.py
│ │ │ ├── pricing_client.py
│ │ │ ├── pricing_transformer.py
│ │ │ ├── report_generator.py
│ │ │ ├── server.py
│ │ │ ├── static
│ │ │ │ ├── __init__.py
│ │ │ │ ├── COST_REPORT_TEMPLATE.md
│ │ │ │ └── patterns
│ │ │ │ ├── __init__.py
│ │ │ │ └── BEDROCK.md
│ │ │ └── terraform_analyzer.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_cdk_analyzer.py
│ │ │ ├── test_helpers.py
│ │ │ ├── test_pricing_client.py
│ │ │ ├── test_pricing_transformer.py
│ │ │ ├── test_report_generator.py
│ │ │ ├── test_server.py
│ │ │ └── test_terraform_analyzer.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── aws-serverless-mcp-server
│ │ ├── .pre-commit.config.yaml
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_serverless_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── models.py
│ │ │ ├── resources
│ │ │ │ ├── __init__.py
│ │ │ │ ├── deployment_details.py
│ │ │ │ ├── deployment_list.py
│ │ │ │ ├── template_details.py
│ │ │ │ └── template_list.py
│ │ │ ├── server.py
│ │ │ ├── template
│ │ │ │ ├── __init__.py
│ │ │ │ ├── registry.py
│ │ │ │ ├── renderer.py
│ │ │ │ └── templates
│ │ │ │ ├── backend.j2
│ │ │ │ ├── frontend.j2
│ │ │ │ ├── fullstack.j2
│ │ │ │ └── README.md
│ │ │ ├── tools
│ │ │ │ ├── common
│ │ │ │ │ └── base_tool.py
│ │ │ │ ├── guidance
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── deploy_serverless_app_help.py
│ │ │ │ │ ├── get_iac_guidance.py
│ │ │ │ │ ├── get_lambda_event_schemas.py
│ │ │ │ │ ├── get_lambda_guidance.py
│ │ │ │ │ └── get_serverless_templates.py
│ │ │ │ ├── sam
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── sam_build.py
│ │ │ │ │ ├── sam_deploy.py
│ │ │ │ │ ├── sam_init.py
│ │ │ │ │ ├── sam_local_invoke.py
│ │ │ │ │ └── sam_logs.py
│ │ │ │ ├── schemas
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── describe_schema.py
│ │ │ │ │ ├── list_registries.py
│ │ │ │ │ └── search_schema.py
│ │ │ │ └── webapps
│ │ │ │ ├── __init__.py
│ │ │ │ ├── configure_domain.py
│ │ │ │ ├── deploy_webapp.py
│ │ │ │ ├── get_metrics.py
│ │ │ │ ├── update_webapp_frontend.py
│ │ │ │ ├── utils
│ │ │ │ │ ├── deploy_service.py
│ │ │ │ │ ├── frontend_uploader.py
│ │ │ │ │ └── startup_script_generator.py
│ │ │ │ └── webapp_deployment_help.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── aws_client_helper.py
│ │ │ ├── cloudformation.py
│ │ │ ├── const.py
│ │ │ ├── deployment_manager.py
│ │ │ ├── github.py
│ │ │ └── process.py
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── test_cloudformation.py
│ │ │ ├── test_configure_domain.py
│ │ │ ├── test_deploy_serverless_app_help.py
│ │ │ ├── test_deploy_service.py
│ │ │ ├── test_deploy_webapp.py
│ │ │ ├── test_deployment_details.py
│ │ │ ├── test_deployment_help.py
│ │ │ ├── test_deployment_list.py
│ │ │ ├── test_deployment_manager.py
│ │ │ ├── test_frontend_uploader.py
│ │ │ ├── test_get_iac_guidance.py
│ │ │ ├── test_get_lambda_event_schemas.py
│ │ │ ├── test_get_lambda_guidance.py
│ │ │ ├── test_get_metrics.py
│ │ │ ├── test_get_serverless_templates.py
│ │ │ ├── test_github.py
│ │ │ ├── test_models.py
│ │ │ ├── test_process.py
│ │ │ ├── test_sam_build.py
│ │ │ ├── test_sam_deploy.py
│ │ │ ├── test_sam_init.py
│ │ │ ├── test_sam_local_invoke.py
│ │ │ ├── test_sam_logs.py
│ │ │ ├── test_schemas.py
│ │ │ ├── test_server.py
│ │ │ ├── test_startup_script_generator.py
│ │ │ ├── test_template_details.py
│ │ │ ├── test_template_list.py
│ │ │ ├── test_template_registry.py
│ │ │ ├── test_template_renderer.py
│ │ │ └── test_update_webapp_frontend.py
│ │ └── uv.lock
│ ├── aws-support-mcp-server
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── aws_support_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── client.py
│ │ │ ├── consts.py
│ │ │ ├── debug_helper.py
│ │ │ ├── errors.py
│ │ │ ├── formatters.py
│ │ │ ├── models.py
│ │ │ └── server.py
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftests.py
│ │ │ ├── test_aws_support_mcp_server.py
│ │ │ └── test_models.py
│ │ └── uv.lock
│ ├── bedrock-kb-retrieval-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── bedrock_kb_retrieval_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── knowledgebases
│ │ │ │ ├── __init__.py
│ │ │ │ ├── clients.py
│ │ │ │ ├── discovery.py
│ │ │ │ └── retrieval.py
│ │ │ ├── models.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── test_clients.py
│ │ │ ├── test_discovery.py
│ │ │ ├── test_env_config.py
│ │ │ ├── test_models.py
│ │ │ ├── test_retrieval.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── billing-cost-management-mcp-server
│ │ ├── __init__.py
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── billing_cost_management_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── models.py
│ │ │ ├── prompts
│ │ │ │ ├── __init__.py
│ │ │ │ ├── decorator.py
│ │ │ │ ├── graviton_migration.py
│ │ │ │ ├── README.md
│ │ │ │ ├── savings_plans.py
│ │ │ │ └── types.py
│ │ │ ├── server.py
│ │ │ ├── templates
│ │ │ │ └── recommendation_templates
│ │ │ │ ├── ebs_volume.template
│ │ │ │ ├── ec2_asg.template
│ │ │ │ ├── ec2_instance.template
│ │ │ │ ├── ecs_service.template
│ │ │ │ ├── idle.template
│ │ │ │ ├── lambda_function.template
│ │ │ │ ├── rds_database.template
│ │ │ │ ├── reserved_instances.template
│ │ │ │ └── savings_plans.template
│ │ │ ├── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── aws_pricing_operations.py
│ │ │ │ ├── aws_pricing_tools.py
│ │ │ │ ├── budget_tools.py
│ │ │ │ ├── compute_optimizer_tools.py
│ │ │ │ ├── cost_anomaly_tools.py
│ │ │ │ ├── cost_comparison_tools.py
│ │ │ │ ├── cost_explorer_operations.py
│ │ │ │ ├── cost_explorer_tools.py
│ │ │ │ ├── cost_optimization_hub_helpers.py
│ │ │ │ ├── cost_optimization_hub_tools.py
│ │ │ │ ├── free_tier_usage_tools.py
│ │ │ │ ├── recommendation_details_tools.py
│ │ │ │ ├── ri_performance_tools.py
│ │ │ │ ├── sp_performance_tools.py
│ │ │ │ ├── storage_lens_tools.py
│ │ │ │ └── unified_sql_tools.py
│ │ │ └── utilities
│ │ │ ├── __init__.py
│ │ │ ├── aws_service_base.py
│ │ │ ├── constants.py
│ │ │ ├── logging_utils.py
│ │ │ └── sql_utils.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── requirements.txt
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── prompts
│ │ │ │ ├── __init__.py
│ │ │ │ └── test_prompts.py
│ │ │ ├── README.md
│ │ │ ├── test_models.py
│ │ │ ├── test_server.py
│ │ │ ├── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── fixtures.py
│ │ │ │ ├── test_aws_pricing_tools.py
│ │ │ │ ├── test_budget_tools.py
│ │ │ │ ├── test_compute_optimizer_tools.py
│ │ │ │ ├── test_cost_anomaly_tools_enhanced.py
│ │ │ │ ├── test_cost_anomaly_tools.py
│ │ │ │ ├── test_cost_comparison_tools.py
│ │ │ │ ├── test_cost_explorer_operations.py
│ │ │ │ ├── test_cost_explorer_tools.py
│ │ │ │ ├── test_cost_optimization_hub_helpers.py
│ │ │ │ ├── test_cost_optimization_hub_tools.py
│ │ │ │ ├── test_free_tier_usage_tools_new.py
│ │ │ │ ├── test_recommendation_details_tools.py
│ │ │ │ ├── test_ri_performance_tools.py
│ │ │ │ ├── test_sp_performance_tools.py
│ │ │ │ ├── test_storage_lens_tools.py
│ │ │ │ └── test_unified_sql_tools.py
│ │ │ └── utilities
│ │ │ ├── test_aws_service_base.py
│ │ │ └── test_sql_utils.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── ccapi-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── ccapi_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── aws_client.py
│ │ │ ├── cloud_control_utils.py
│ │ │ ├── context.py
│ │ │ ├── errors.py
│ │ │ ├── iac_generator.py
│ │ │ ├── impl
│ │ │ │ ├── __init__.py
│ │ │ │ ├── tools
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── explanation.py
│ │ │ │ │ ├── infrastructure_generation.py
│ │ │ │ │ ├── resource_operations.py
│ │ │ │ │ ├── security_scanning.py
│ │ │ │ │ └── session_management.py
│ │ │ │ └── utils
│ │ │ │ ├── __init__.py
│ │ │ │ └── validation.py
│ │ │ ├── infrastructure_generator.py
│ │ │ ├── models
│ │ │ │ ├── __init__.py
│ │ │ │ └── models.py
│ │ │ ├── schema_manager.py
│ │ │ ├── server.py
│ │ │ └── static
│ │ │ └── __init__.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── test_aws_client.py
│ │ │ ├── test_checkov_install.py
│ │ │ ├── test_cloud_control_utils.py
│ │ │ ├── test_context.py
│ │ │ ├── test_errors.py
│ │ │ ├── test_explanation.py
│ │ │ ├── test_iac_generator.py
│ │ │ ├── test_infrastructure_generation.py
│ │ │ ├── test_infrastructure_generator.py
│ │ │ ├── test_models.py
│ │ │ ├── test_resource_operations.py
│ │ │ ├── test_schema_manager.py
│ │ │ ├── test_security_scanning.py
│ │ │ ├── test_server.py
│ │ │ ├── test_session_management.py
│ │ │ └── test_validation.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── cdk-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── cdk_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── core
│ │ │ │ ├── __init__.py
│ │ │ │ ├── resources.py
│ │ │ │ ├── search_utils.py
│ │ │ │ ├── server.py
│ │ │ │ └── tools.py
│ │ │ ├── data
│ │ │ │ ├── __init__.py
│ │ │ │ ├── cdk_nag_parser.py
│ │ │ │ ├── construct_descriptions.py
│ │ │ │ ├── genai_cdk_loader.py
│ │ │ │ ├── lambda_layer_parser.py
│ │ │ │ ├── lambda_powertools_loader.py
│ │ │ │ ├── schema_generator.py
│ │ │ │ └── solutions_constructs_parser.py
│ │ │ ├── server.py
│ │ │ └── static
│ │ │ ├── __init__.py
│ │ │ ├── CDK_GENERAL_GUIDANCE.md
│ │ │ ├── CDK_NAG_GUIDANCE.md
│ │ │ └── lambda_powertools
│ │ │ ├── bedrock.md
│ │ │ ├── cdk.md
│ │ │ ├── dependencies.md
│ │ │ ├── index.md
│ │ │ ├── insights.md
│ │ │ ├── logging.md
│ │ │ ├── metrics.md
│ │ │ └── tracing.md
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── core
│ │ │ │ ├── test_resources_enhanced.py
│ │ │ │ ├── test_resources.py
│ │ │ │ ├── test_search_utils.py
│ │ │ │ ├── test_server.py
│ │ │ │ └── test_tools.py
│ │ │ └── data
│ │ │ ├── test_cdk_nag_parser.py
│ │ │ ├── test_genai_cdk_loader.py
│ │ │ ├── test_lambda_powertools_loader.py
│ │ │ ├── test_schema_generator.py
│ │ │ └── test_solutions_constructs_parser.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── cfn-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── cfn_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── aws_client.py
│ │ │ ├── cloud_control_utils.py
│ │ │ ├── context.py
│ │ │ ├── errors.py
│ │ │ ├── iac_generator.py
│ │ │ ├── schema_manager.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── test_aws_client.py
│ │ │ ├── test_cloud_control_utils.py
│ │ │ ├── test_errors.py
│ │ │ ├── test_iac_generator.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_schema_manager.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── cloudtrail-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── cloudtrail_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── common.py
│ │ │ ├── models.py
│ │ │ ├── server.py
│ │ │ └── tools.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_models.py
│ │ │ ├── test_server.py
│ │ │ └── test_tools.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── cloudwatch-appsignals-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── cloudwatch_appsignals_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── audit_presentation_utils.py
│ │ │ ├── audit_utils.py
│ │ │ ├── aws_clients.py
│ │ │ ├── canary_utils.py
│ │ │ ├── server.py
│ │ │ ├── service_audit_utils.py
│ │ │ ├── service_tools.py
│ │ │ ├── sli_report_client.py
│ │ │ ├── slo_tools.py
│ │ │ ├── trace_tools.py
│ │ │ └── utils.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ ├── test_audit_presentation_utils.py
│ │ │ ├── test_audit_utils.py
│ │ │ ├── test_aws_profile.py
│ │ │ ├── test_canary_utils.py
│ │ │ ├── test_initialization.py
│ │ │ ├── test_server_audit_functions.py
│ │ │ ├── test_server_audit_tools.py
│ │ │ ├── test_server.py
│ │ │ ├── test_service_audit_utils.py
│ │ │ ├── test_service_tools_operations.py
│ │ │ ├── test_sli_report_client.py
│ │ │ ├── test_slo_tools.py
│ │ │ └── test_utils.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── cloudwatch-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── cloudwatch_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── cloudwatch_alarms
│ │ │ │ ├── models.py
│ │ │ │ └── tools.py
│ │ │ ├── cloudwatch_logs
│ │ │ │ ├── models.py
│ │ │ │ └── tools.py
│ │ │ ├── cloudwatch_metrics
│ │ │ │ ├── data
│ │ │ │ │ └── metric_metadata.json
│ │ │ │ ├── models.py
│ │ │ │ └── tools.py
│ │ │ ├── common.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── cloudwatch_alarms
│ │ │ │ ├── test_active_alarms.py
│ │ │ │ ├── test_alarm_history_integration.py
│ │ │ │ ├── test_alarm_history.py
│ │ │ │ └── test_alarms_error_handling.py
│ │ │ ├── cloudwatch_logs
│ │ │ │ ├── test_logs_error_handling.py
│ │ │ │ ├── test_logs_models.py
│ │ │ │ └── test_logs_server.py
│ │ │ ├── cloudwatch_metrics
│ │ │ │ ├── test_metrics_error_handling.py
│ │ │ │ ├── test_metrics_models.py
│ │ │ │ ├── test_metrics_server.py
│ │ │ │ └── test_validation_error.py
│ │ │ ├── test_common_and_server.py
│ │ │ ├── test_init.py
│ │ │ └── test_main.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── code-doc-gen-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── code_doc_gen_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── server.py
│ │ │ └── utils
│ │ │ ├── doc_generator.py
│ │ │ ├── models.py
│ │ │ ├── repomix_manager.py
│ │ │ └── templates.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_doc_generator_edge_cases.py
│ │ │ ├── test_doc_generator.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_repomix_manager_scenarios.py
│ │ │ ├── test_repomix_manager.py
│ │ │ ├── test_repomix_statistics.py
│ │ │ ├── test_server_extended.py
│ │ │ ├── test_server.py
│ │ │ └── test_templates.py
│ │ └── uv.lock
│ ├── core-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── core_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── server.py
│ │ │ └── static
│ │ │ ├── __init__.py
│ │ │ └── PROMPT_UNDERSTANDING.md
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_response_types.py
│ │ │ ├── test_server.py
│ │ │ └── test_static.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── cost-explorer-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── cost_explorer_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── comparison_handler.py
│ │ │ ├── constants.py
│ │ │ ├── cost_usage_handler.py
│ │ │ ├── forecasting_handler.py
│ │ │ ├── helpers.py
│ │ │ ├── metadata_handler.py
│ │ │ ├── models.py
│ │ │ ├── server.py
│ │ │ └── utility_handler.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_comparison_handler.py
│ │ │ ├── test_cost_usage_handler.py
│ │ │ ├── test_forecasting_handler.py
│ │ │ ├── test_helpers.py
│ │ │ ├── test_metadata_handler.py
│ │ │ ├── test_models.py
│ │ │ ├── test_server.py
│ │ │ └── test_utility_handler.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── documentdb-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ └── documentdb_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── analytic_tools.py
│ │ │ ├── config.py
│ │ │ ├── connection_tools.py
│ │ │ ├── db_management_tools.py
│ │ │ ├── query_tools.py
│ │ │ ├── server.py
│ │ │ └── write_tools.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ ├── test_analytic_tools.py
│ │ │ ├── test_connection_tools.py
│ │ │ ├── test_db_management_tools.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_query_tools.py
│ │ │ └── test_write_tools.py
│ │ └── uv.lock
│ ├── dynamodb-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── dynamodb_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── common.py
│ │ │ ├── database_analysis_queries.py
│ │ │ ├── database_analyzers.py
│ │ │ ├── prompts
│ │ │ │ └── dynamodb_architect.md
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── evals
│ │ │ │ ├── dynamic_evaluators.py
│ │ │ │ ├── evaluation_registry.py
│ │ │ │ ├── logging_config.py
│ │ │ │ ├── multiturn_evaluator.py
│ │ │ │ ├── README.md
│ │ │ │ ├── scenarios.py
│ │ │ │ └── test_dspy_evals.py
│ │ │ ├── test_dynamodb_server.py
│ │ │ └── test_source_db_integration.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── ecs-mcp-server
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── ecs_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── api
│ │ │ │ ├── __init__.py
│ │ │ │ ├── containerize.py
│ │ │ │ ├── delete.py
│ │ │ │ ├── ecs_troubleshooting.py
│ │ │ │ ├── infrastructure.py
│ │ │ │ ├── resource_management.py
│ │ │ │ ├── status.py
│ │ │ │ └── troubleshooting_tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── detect_image_pull_failures.py
│ │ │ │ ├── fetch_cloudformation_status.py
│ │ │ │ ├── fetch_network_configuration.py
│ │ │ │ ├── fetch_service_events.py
│ │ │ │ ├── fetch_task_failures.py
│ │ │ │ ├── fetch_task_logs.py
│ │ │ │ ├── get_ecs_troubleshooting_guidance.py
│ │ │ │ └── utils.py
│ │ │ ├── main.py
│ │ │ ├── modules
│ │ │ │ ├── __init__.py
│ │ │ │ ├── aws_knowledge_proxy.py
│ │ │ │ ├── containerize.py
│ │ │ │ ├── delete.py
│ │ │ │ ├── deployment_status.py
│ │ │ │ ├── infrastructure.py
│ │ │ │ ├── resource_management.py
│ │ │ │ └── troubleshooting.py
│ │ │ ├── templates
│ │ │ │ ├── ecr_infrastructure.json
│ │ │ │ └── ecs_infrastructure.json
│ │ │ └── utils
│ │ │ ├── arn_parser.py
│ │ │ ├── aws.py
│ │ │ ├── config.py
│ │ │ ├── docker.py
│ │ │ ├── security.py
│ │ │ ├── templates.py
│ │ │ └── time_utils.py
│ │ ├── DEVELOPMENT.md
│ │ ├── pyproject.toml
│ │ ├── pyrightconfig.json
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── integ
│ │ │ │ └── mcp-inspector
│ │ │ │ ├── .gitignore
│ │ │ │ ├── README.md
│ │ │ │ ├── run-tests.sh
│ │ │ │ └── scenarios
│ │ │ │ ├── 01_comprehensive_troubleshooting
│ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ ├── 03_cleanup.sh
│ │ │ │ │ ├── description.txt
│ │ │ │ │ └── utils
│ │ │ │ │ ├── mcp_helpers.sh
│ │ │ │ │ └── validation_helpers.sh
│ │ │ │ └── 02_test_knowledge_proxy_tools
│ │ │ │ ├── 01_create.sh
│ │ │ │ ├── 02_validate.sh
│ │ │ │ ├── 03_cleanup.sh
│ │ │ │ ├── description.txt
│ │ │ │ └── utils
│ │ │ │ ├── knowledge_validation_helpers.sh
│ │ │ │ └── mcp_knowledge_helpers.sh
│ │ │ ├── llm_testing
│ │ │ │ ├── invalid_cfn_template.yaml
│ │ │ │ ├── README.md
│ │ │ │ ├── run_tests.sh
│ │ │ │ ├── scenarios
│ │ │ │ │ ├── 01_cloudformation_failure
│ │ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ │ ├── 03_prompts.txt
│ │ │ │ │ │ ├── 04_evaluation.md
│ │ │ │ │ │ ├── 05_cleanup.sh
│ │ │ │ │ │ └── description.txt
│ │ │ │ │ ├── 02_service_failure
│ │ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ │ ├── 03_prompts.txt
│ │ │ │ │ │ ├── 04_evaluation.md
│ │ │ │ │ │ ├── 05_cleanup.sh
│ │ │ │ │ │ └── description.txt
│ │ │ │ │ ├── 03_task_exit_failure
│ │ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ │ ├── 03_prompts.txt
│ │ │ │ │ │ ├── 04_evaluation.md
│ │ │ │ │ │ ├── 05_cleanup.sh
│ │ │ │ │ │ └── description.txt
│ │ │ │ │ ├── 04_network_configuration_failure
│ │ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ │ ├── 03_prompts.txt
│ │ │ │ │ │ ├── 05_cleanup.sh
│ │ │ │ │ │ └── description.txt
│ │ │ │ │ ├── 05_resource_constraint_failure
│ │ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ │ ├── 03_prompts.txt
│ │ │ │ │ │ ├── 05_cleanup.sh
│ │ │ │ │ │ └── description.txt
│ │ │ │ │ └── 06_load_balancer_failure
│ │ │ │ │ ├── 01_create.sh
│ │ │ │ │ ├── 02_validate.sh
│ │ │ │ │ ├── 03_prompts.txt
│ │ │ │ │ ├── 05_cleanup.sh
│ │ │ │ │ └── description.txt
│ │ │ │ ├── SCRIPT_IMPROVEMENTS.md
│ │ │ │ └── utils
│ │ │ │ ├── aws_helpers.sh
│ │ │ │ └── evaluation_template.md
│ │ │ └── unit
│ │ │ ├── __init__.py
│ │ │ ├── api
│ │ │ │ ├── conftest.py
│ │ │ │ ├── test_delete_api.py
│ │ │ │ ├── test_ecs_troubleshooting.py
│ │ │ │ ├── test_resource_management_api.py
│ │ │ │ └── troubleshooting_tools
│ │ │ │ └── test_fetch_network_configuration.py
│ │ │ ├── conftest.py
│ │ │ ├── modules
│ │ │ │ ├── test_aws_knowledge_proxy.py
│ │ │ │ └── test_resource_management_module.py
│ │ │ ├── test_aws_role_utils.py
│ │ │ ├── test_aws_utils.py
│ │ │ ├── test_containerize.py
│ │ │ ├── test_delete.py
│ │ │ ├── test_docker_utils.py
│ │ │ ├── test_docker_with_role.py
│ │ │ ├── test_image_pull_failure_extended.py
│ │ │ ├── test_image_pull_failure.py
│ │ │ ├── test_infrastructure_role.py
│ │ │ ├── test_infrastructure.py
│ │ │ ├── test_integration.py
│ │ │ ├── test_main.py
│ │ │ ├── test_resource_management_api_operation.py
│ │ │ ├── test_resource_management_tool.py
│ │ │ ├── test_resource_management.py
│ │ │ ├── test_security_integration.py
│ │ │ ├── test_status_pytest.py
│ │ │ ├── test_status.py
│ │ │ ├── troubleshooting_tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── conftest.py
│ │ │ │ ├── test_detect_image_pull_failures.py
│ │ │ │ ├── test_fetch_cloudformation_status.py
│ │ │ │ ├── test_fetch_service_events.py
│ │ │ │ ├── test_fetch_task_failures.py
│ │ │ │ ├── test_fetch_task_logs.py
│ │ │ │ ├── test_get_ecs_troubleshooting_guidance.py
│ │ │ │ ├── test_is_ecr_image_security.py
│ │ │ │ └── test_utils.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── async_test_utils.py
│ │ │ ├── test_arn_parser.py
│ │ │ ├── test_config.py
│ │ │ ├── test_docker.py
│ │ │ ├── test_response_sanitization.py
│ │ │ ├── test_security_extended.py
│ │ │ ├── test_security.py
│ │ │ ├── test_templates.py
│ │ │ └── test_time_utils.py
│ │ └── uv.lock
│ ├── eks-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── eks_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── aws_helper.py
│ │ │ ├── cloudwatch_handler.py
│ │ │ ├── cloudwatch_metrics_guidance_handler.py
│ │ │ ├── consts.py
│ │ │ ├── data
│ │ │ │ └── eks_cloudwatch_metrics_guidance.json
│ │ │ ├── eks_kb_handler.py
│ │ │ ├── eks_stack_handler.py
│ │ │ ├── iam_handler.py
│ │ │ ├── insights_handler.py
│ │ │ ├── k8s_apis.py
│ │ │ ├── k8s_client_cache.py
│ │ │ ├── k8s_handler.py
│ │ │ ├── logging_helper.py
│ │ │ ├── models.py
│ │ │ ├── scripts
│ │ │ │ └── update_eks_cloudwatch_metrics_guidance.py
│ │ │ ├── server.py
│ │ │ ├── templates
│ │ │ │ ├── eks-templates
│ │ │ │ │ └── eks-with-vpc.yaml
│ │ │ │ └── k8s-templates
│ │ │ │ ├── deployment.yaml
│ │ │ │ └── service.yaml
│ │ │ └── vpc_config_handler.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_aws_helper.py
│ │ │ ├── test_cloudwatch_handler.py
│ │ │ ├── test_cloudwatch_metrics_guidance_handler.py
│ │ │ ├── test_eks_kb_handler.py
│ │ │ ├── test_eks_stack_handler.py
│ │ │ ├── test_iam_handler.py
│ │ │ ├── test_init.py
│ │ │ ├── test_insights_handler.py
│ │ │ ├── test_k8s_apis.py
│ │ │ ├── test_k8s_client_cache.py
│ │ │ ├── test_k8s_handler.py
│ │ │ ├── test_logging_helper.py
│ │ │ ├── test_main.py
│ │ │ ├── test_models.py
│ │ │ ├── test_server.py
│ │ │ └── test_vpc_config_handler.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── elasticache-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── elasticache_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── common
│ │ │ │ ├── __init__.py
│ │ │ │ ├── connection.py
│ │ │ │ ├── decorators.py
│ │ │ │ └── server.py
│ │ │ ├── context.py
│ │ │ ├── main.py
│ │ │ └── tools
│ │ │ ├── __init__.py
│ │ │ ├── cc
│ │ │ │ ├── __init__.py
│ │ │ │ ├── connect.py
│ │ │ │ ├── create.py
│ │ │ │ ├── delete.py
│ │ │ │ ├── describe.py
│ │ │ │ ├── modify.py
│ │ │ │ ├── parsers.py
│ │ │ │ └── processors.py
│ │ │ ├── ce
│ │ │ │ ├── __init__.py
│ │ │ │ └── get_cost_and_usage.py
│ │ │ ├── cw
│ │ │ │ ├── __init__.py
│ │ │ │ └── get_metric_statistics.py
│ │ │ ├── cwlogs
│ │ │ │ ├── __init__.py
│ │ │ │ ├── create_log_group.py
│ │ │ │ ├── describe_log_groups.py
│ │ │ │ ├── describe_log_streams.py
│ │ │ │ ├── filter_log_events.py
│ │ │ │ └── get_log_events.py
│ │ │ ├── firehose
│ │ │ │ ├── __init__.py
│ │ │ │ └── list_delivery_streams.py
│ │ │ ├── misc
│ │ │ │ ├── __init__.py
│ │ │ │ ├── batch_apply_update_action.py
│ │ │ │ ├── batch_stop_update_action.py
│ │ │ │ ├── describe_cache_engine_versions.py
│ │ │ │ ├── describe_engine_default_parameters.py
│ │ │ │ ├── describe_events.py
│ │ │ │ └── describe_service_updates.py
│ │ │ ├── rg
│ │ │ │ ├── __init__.py
│ │ │ │ ├── complete_migration.py
│ │ │ │ ├── connect.py
│ │ │ │ ├── create.py
│ │ │ │ ├── delete.py
│ │ │ │ ├── describe.py
│ │ │ │ ├── modify.py
│ │ │ │ ├── parsers.py
│ │ │ │ ├── processors.py
│ │ │ │ ├── start_migration.py
│ │ │ │ └── test_migration.py
│ │ │ └── serverless
│ │ │ ├── __init__.py
│ │ │ ├── connect.py
│ │ │ ├── create.py
│ │ │ ├── delete.py
│ │ │ ├── describe.py
│ │ │ ├── models.py
│ │ │ └── modify.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_connection.py
│ │ │ ├── test_decorators.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── tools
│ │ │ ├── cc
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_connect_additional.py
│ │ │ │ ├── test_connect_coverage_additional.py
│ │ │ │ ├── test_connect_coverage.py
│ │ │ │ ├── test_connect.py
│ │ │ │ ├── test_create_additional.py
│ │ │ │ ├── test_create.py
│ │ │ │ ├── test_delete.py
│ │ │ │ ├── test_describe.py
│ │ │ │ ├── test_modify.py
│ │ │ │ ├── test_parsers.py
│ │ │ │ └── test_processors.py
│ │ │ ├── ce
│ │ │ │ ├── __init__.py
│ │ │ │ └── test_get_cost_and_usage.py
│ │ │ ├── cw
│ │ │ │ └── test_get_metric_statistics.py
│ │ │ ├── cwlogs
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_create_log_group.py
│ │ │ │ ├── test_describe_log_groups.py
│ │ │ │ ├── test_describe_log_streams.py
│ │ │ │ ├── test_filter_log_events.py
│ │ │ │ └── test_get_log_events.py
│ │ │ ├── firehose
│ │ │ │ └── test_list_delivery_streams.py
│ │ │ ├── misc
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_batch_apply_update_action.py
│ │ │ │ ├── test_batch_stop_update_action.py
│ │ │ │ ├── test_describe_cache_engine_versions.py
│ │ │ │ ├── test_describe_engine_default_parameters.py
│ │ │ │ ├── test_describe_events.py
│ │ │ │ └── test_describe_service_updates.py
│ │ │ ├── rg
│ │ │ │ ├── __init__.py
│ │ │ │ ├── test_complete_migration.py
│ │ │ │ ├── test_connect_additional.py
│ │ │ │ ├── test_connect_coverage_additional.py
│ │ │ │ ├── test_connect_optional_fields.py
│ │ │ │ ├── test_connect_partial_coverage.py
│ │ │ │ ├── test_connect.py
│ │ │ │ ├── test_create.py
│ │ │ │ ├── test_delete.py
│ │ │ │ ├── test_describe.py
│ │ │ │ ├── test_modify.py
│ │ │ │ ├── test_parsers.py
│ │ │ │ ├── test_processors.py
│ │ │ │ ├── test_start_migration.py
│ │ │ │ └── test_test_migration.py
│ │ │ └── serverless
│ │ │ ├── test_connect_additional.py
│ │ │ ├── test_connect_coverage_additional.py
│ │ │ ├── test_connect_optional_fields.py
│ │ │ ├── test_connect.py
│ │ │ ├── test_create.py
│ │ │ ├── test_delete.py
│ │ │ ├── test_describe.py
│ │ │ └── test_modify.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── finch-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── finch_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── consts.py
│ │ │ ├── models.py
│ │ │ ├── server.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── build.py
│ │ │ ├── common.py
│ │ │ ├── ecr.py
│ │ │ ├── push.py
│ │ │ └── vm.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── test_cli_flags.py
│ │ │ ├── test_logging_configuration.py
│ │ │ ├── test_server.py
│ │ │ ├── test_utils_build.py
│ │ │ ├── test_utils_common.py
│ │ │ ├── test_utils_ecr.py
│ │ │ ├── test_utils_push.py
│ │ │ └── test_utils_vm.py
│ │ └── uv.lock
│ ├── frontend-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── frontend_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── server.py
│ │ │ ├── static
│ │ │ │ └── react
│ │ │ │ ├── essential-knowledge.md
│ │ │ │ └── troubleshooting.md
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ └── file_utils.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_file_utils.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── test_server.py
│ │ └── uv.lock
│ ├── git-repo-research-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── git_repo_research_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── defaults.py
│ │ │ ├── embeddings.py
│ │ │ ├── github_search.py
│ │ │ ├── indexer.py
│ │ │ ├── models.py
│ │ │ ├── repository.py
│ │ │ ├── search.py
│ │ │ ├── server.py
│ │ │ └── utils.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_errors_repository.py
│ │ │ ├── test_github_search_edge_cases.py
│ │ │ ├── test_graphql_github_search.py
│ │ │ ├── test_local_repository.py
│ │ │ ├── test_repository_utils.py
│ │ │ ├── test_rest_github_search.py
│ │ │ ├── test_search.py
│ │ │ ├── test_server.py
│ │ │ └── test_url_repository.py
│ │ └── uv.lock
│ ├── healthlake-mcp-server
│ │ ├── .dockerignore
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── healthlake_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── fhir_operations.py
│ │ │ ├── main.py
│ │ │ ├── models.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── CONTRIBUTING.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── examples
│ │ │ ├── mcp_config.json
│ │ │ └── README.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ ├── test_fhir_client_comprehensive.py
│ │ │ ├── test_fhir_error_scenarios.py
│ │ │ ├── test_fhir_operations.py
│ │ │ ├── test_integration_mock_based.py
│ │ │ ├── test_main_edge_cases.py
│ │ │ ├── test_main.py
│ │ │ ├── test_mcp_integration_coverage.py
│ │ │ ├── test_models_edge_cases.py
│ │ │ ├── test_models.py
│ │ │ ├── test_readonly_mode.py
│ │ │ ├── test_server_core.py
│ │ │ ├── test_server_error_handling.py
│ │ │ ├── test_server_mcp_handlers.py
│ │ │ ├── test_server_toolhandler.py
│ │ │ └── test_server_validation.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── iam-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── iam_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── aws_client.py
│ │ │ ├── context.py
│ │ │ ├── errors.py
│ │ │ ├── models.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── DESIGN_COMPLIANCE.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── examples
│ │ │ ├── get_policy_document_example.py
│ │ │ └── inline_policy_demo.py
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── run_tests.sh
│ │ ├── tests
│ │ │ ├── test_context.py
│ │ │ ├── test_errors.py
│ │ │ ├── test_inline_policies.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── lambda-tool-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── lambda_tool_mcp_server
│ │ │ ├── __init__.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── examples
│ │ │ ├── README.md
│ │ │ └── sample_functions
│ │ │ ├── customer-create
│ │ │ │ └── app.py
│ │ │ ├── customer-id-from-email
│ │ │ │ └── app.py
│ │ │ ├── customer-info-from-id
│ │ │ │ └── app.py
│ │ │ └── template.yml
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── test_format_lambda_response.py
│ │ │ ├── test_integration_coverage.py
│ │ │ ├── test_integration.py
│ │ │ ├── test_register_lambda_functions.py
│ │ │ ├── test_schema_integration.py
│ │ │ ├── test_server_coverage_additional.py
│ │ │ ├── test_server_coverage.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── mcp-lambda-handler
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ └── mcp_lambda_handler
│ │ │ ├── __init__.py
│ │ │ ├── mcp_lambda_handler.py
│ │ │ ├── session.py
│ │ │ └── types.py
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ └── test_lambda_handler.py
│ │ └── uv.lock
│ ├── memcached-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── memcached_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── common
│ │ │ │ ├── config.py
│ │ │ │ ├── connection.py
│ │ │ │ └── server.py
│ │ │ ├── context.py
│ │ │ ├── main.py
│ │ │ └── tools
│ │ │ └── cache.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── ELASTICACHECONNECT.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_cache_readonly.py
│ │ │ ├── test_cache.py
│ │ │ ├── test_connection.py
│ │ │ ├── test_init.py
│ │ │ └── test_main.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── mysql-mcp-server
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── mysql_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── mutable_sql_detector.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── nova-canvas-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── nova_canvas_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── consts.py
│ │ │ ├── models.py
│ │ │ ├── novacanvas.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── test_models.py
│ │ │ ├── test_novacanvas.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── openapi-mcp-server
│ │ ├── .coveragerc
│ │ ├── .dockerignore
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── AUTHENTICATION.md
│ │ ├── AWS_BEST_PRACTICES.md
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── openapi_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── api
│ │ │ │ ├── __init__.py
│ │ │ │ └── config.py
│ │ │ ├── auth
│ │ │ │ ├── __init__.py
│ │ │ │ ├── api_key_auth.py
│ │ │ │ ├── auth_cache.py
│ │ │ │ ├── auth_errors.py
│ │ │ │ ├── auth_factory.py
│ │ │ │ ├── auth_protocol.py
│ │ │ │ ├── auth_provider.py
│ │ │ │ ├── base_auth.py
│ │ │ │ ├── basic_auth.py
│ │ │ │ ├── bearer_auth.py
│ │ │ │ ├── cognito_auth.py
│ │ │ │ └── register.py
│ │ │ ├── patch
│ │ │ │ └── __init__.py
│ │ │ ├── prompts
│ │ │ │ ├── __init__.py
│ │ │ │ ├── generators
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── operation_prompts.py
│ │ │ │ │ └── workflow_prompts.py
│ │ │ │ ├── models.py
│ │ │ │ └── prompt_manager.py
│ │ │ ├── server.py
│ │ │ └── utils
│ │ │ ├── __init__.py
│ │ │ ├── cache_provider.py
│ │ │ ├── config.py
│ │ │ ├── error_handler.py
│ │ │ ├── http_client.py
│ │ │ ├── metrics_provider.py
│ │ │ ├── openapi_validator.py
│ │ │ └── openapi.py
│ │ ├── CHANGELOG.md
│ │ ├── DEPLOYMENT.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── OBSERVABILITY.md
│ │ ├── pyproject.toml
│ │ ├── pyrightconfig.json
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── api
│ │ │ │ └── test_config.py
│ │ │ ├── auth
│ │ │ │ ├── test_api_key_auth.py
│ │ │ │ ├── test_auth_cache.py
│ │ │ │ ├── test_auth_errors.py
│ │ │ │ ├── test_auth_factory_caching.py
│ │ │ │ ├── test_auth_factory_coverage.py
│ │ │ │ ├── test_auth_factory.py
│ │ │ │ ├── test_auth_protocol_additional.py
│ │ │ │ ├── test_auth_protocol_boost.py
│ │ │ │ ├── test_auth_protocol_coverage.py
│ │ │ │ ├── test_auth_protocol_extended.py
│ │ │ │ ├── test_auth_protocol_improved.py
│ │ │ │ ├── test_auth_protocol.py
│ │ │ │ ├── test_auth_provider_additional.py
│ │ │ │ ├── test_base_auth_coverage.py
│ │ │ │ ├── test_base_auth.py
│ │ │ │ ├── test_basic_auth.py
│ │ │ │ ├── test_bearer_auth.py
│ │ │ │ ├── test_cognito_auth_additional_coverage.py
│ │ │ │ ├── test_cognito_auth_boost_coverage.py
│ │ │ │ ├── test_cognito_auth_client_credentials.py
│ │ │ │ ├── test_cognito_auth_coverage_boost.py
│ │ │ │ ├── test_cognito_auth_exceptions.py
│ │ │ │ ├── test_cognito_auth.py
│ │ │ │ ├── test_register_coverage.py
│ │ │ │ └── test_register.py
│ │ │ ├── prompts
│ │ │ │ ├── standalone
│ │ │ │ │ ├── test_operation_prompt.py
│ │ │ │ │ ├── test_prompt_arguments.py
│ │ │ │ │ └── test_secure_operation_prompt.py
│ │ │ │ ├── test_mcp_prompt_manager_integration.py
│ │ │ │ ├── test_mcp_prompt_manager.py
│ │ │ │ ├── test_models_dict_method.py
│ │ │ │ ├── test_operation_prompts_extended.py
│ │ │ │ ├── test_prompt_manager_additional.py
│ │ │ │ ├── test_prompt_manager_comprehensive.py
│ │ │ │ ├── test_prompt_manager_coverage.py
│ │ │ │ └── test_prompt_registration.py
│ │ │ ├── README.md
│ │ │ ├── test_api_name.py
│ │ │ ├── test_cache_coverage_89.py
│ │ │ ├── test_client.py
│ │ │ ├── test_coverage_boost.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main_extended.py
│ │ │ ├── test_main.py
│ │ │ ├── test_openapi_coverage_89.py
│ │ │ ├── test_server_auth_errors.py
│ │ │ ├── test_server_coverage_boost_2.py
│ │ │ ├── test_server_coverage_boost.py
│ │ │ ├── test_server_exception_handling.py
│ │ │ ├── test_server_extended.py
│ │ │ ├── test_server_httpx_version.py
│ │ │ ├── test_server_part1.py
│ │ │ ├── test_server_route_logging.py
│ │ │ ├── test_server_signal_handlers.py
│ │ │ ├── test_server.py
│ │ │ └── utils
│ │ │ ├── test_cache_provider.py
│ │ │ ├── test_error_handler_boost.py
│ │ │ ├── test_error_handler_extended.py
│ │ │ ├── test_error_handler_fix.py
│ │ │ ├── test_error_handler.py
│ │ │ ├── test_http_client_comprehensive.py
│ │ │ ├── test_http_client_extended.py
│ │ │ ├── test_http_client_extended2.py
│ │ │ ├── test_http_client_import_error.py
│ │ │ ├── test_http_client.py
│ │ │ ├── test_metrics_provider_decorators.py
│ │ │ ├── test_metrics_provider_extended2.py
│ │ │ ├── test_metrics_provider_prometheus.py
│ │ │ ├── test_metrics_provider.py
│ │ │ ├── test_openapi_validator.py
│ │ │ └── test_openapi.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── postgres-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── postgres_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── connection
│ │ │ │ ├── __init__.py
│ │ │ │ ├── abstract_db_connection.py
│ │ │ │ ├── db_connection_singleton.py
│ │ │ │ ├── psycopg_pool_connection.py
│ │ │ │ └── rds_api_connection.py
│ │ │ ├── mutable_sql_detector.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ ├── test_psycopg_connector.py
│ │ │ ├── test_server.py
│ │ │ └── test_singleton.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── prometheus-mcp-server
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── prometheus_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── consts.py
│ │ │ ├── models.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── conftest.py
│ │ │ ├── test_aws_credentials.py
│ │ │ ├── test_config_manager.py
│ │ │ ├── test_consts.py
│ │ │ ├── test_coverage_gaps.py
│ │ │ ├── test_coverage_improvement.py
│ │ │ ├── test_final_coverage.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_models.py
│ │ │ ├── test_prometheus_client.py
│ │ │ ├── test_prometheus_connection.py
│ │ │ ├── test_security_validator.py
│ │ │ ├── test_server_coverage.py
│ │ │ ├── test_tools.py
│ │ │ └── test_workspace_config.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── redshift-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── redshift_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── consts.py
│ │ │ ├── models.py
│ │ │ ├── redshift.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_redshift.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── s3-tables-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── s3_tables_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── constants.py
│ │ │ ├── database.py
│ │ │ ├── engines
│ │ │ │ ├── __init__.py
│ │ │ │ └── pyiceberg.py
│ │ │ ├── file_processor
│ │ │ │ ├── __init__.py
│ │ │ │ ├── csv.py
│ │ │ │ ├── parquet.py
│ │ │ │ └── utils.py
│ │ │ ├── models.py
│ │ │ ├── namespaces.py
│ │ │ ├── resources.py
│ │ │ ├── s3_operations.py
│ │ │ ├── server.py
│ │ │ ├── table_buckets.py
│ │ │ ├── tables.py
│ │ │ └── utils.py
│ │ ├── CHANGELOG.md
│ │ ├── CONTEXT.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_csv.py
│ │ │ ├── test_database.py
│ │ │ ├── test_file_processor_utils.py
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ ├── test_namespaces.py
│ │ │ ├── test_parquet.py
│ │ │ ├── test_pyiceberg.py
│ │ │ ├── test_resources.py
│ │ │ ├── test_s3_operations.py
│ │ │ ├── test_server.py
│ │ │ ├── test_table_buckets.py
│ │ │ ├── test_tables.py
│ │ │ └── test_utils.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── stepfunctions-tool-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── stepfunctions_tool_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── aws_helper.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── README.md
│ │ │ ├── test_aws_helper.py
│ │ │ ├── test_create_state_machine_tool.py
│ │ │ ├── test_filter_state_machines_by_tag.py
│ │ │ ├── test_format_state_machine_response.py
│ │ │ ├── test_get_schema_arn_from_state_machine_arn.py
│ │ │ ├── test_get_schema_from_registry.py
│ │ │ ├── test_invoke_express_state_machine_impl.py
│ │ │ ├── test_invoke_standard_state_machine_impl.py
│ │ │ ├── test_main.py
│ │ │ ├── test_register_state_machines.py
│ │ │ ├── test_sanitize_tool_name.py
│ │ │ ├── test_server.py
│ │ │ └── test_validate_state_machine_name.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── syntheticdata-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── syntheticdata_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── pandas_interpreter.py
│ │ │ ├── server.py
│ │ │ └── storage
│ │ │ ├── __init__.py
│ │ │ ├── base.py
│ │ │ ├── loader.py
│ │ │ └── s3.py
│ │ ├── CHANGELOG.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── conftest.py
│ │ │ ├── test_constants.py
│ │ │ ├── test_pandas_interpreter.py
│ │ │ ├── test_server.py
│ │ │ └── test_storage
│ │ │ ├── __init__.py
│ │ │ ├── test_loader.py
│ │ │ └── test_s3.py
│ │ └── uv.lock
│ ├── terraform-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── terraform_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── impl
│ │ │ │ ├── resources
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── terraform_aws_provider_resources_listing.py
│ │ │ │ │ └── terraform_awscc_provider_resources_listing.py
│ │ │ │ └── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── execute_terraform_command.py
│ │ │ │ ├── execute_terragrunt_command.py
│ │ │ │ ├── run_checkov_scan.py
│ │ │ │ ├── search_aws_provider_docs.py
│ │ │ │ ├── search_awscc_provider_docs.py
│ │ │ │ ├── search_specific_aws_ia_modules.py
│ │ │ │ ├── search_user_provided_module.py
│ │ │ │ └── utils.py
│ │ │ ├── models
│ │ │ │ ├── __init__.py
│ │ │ │ └── models.py
│ │ │ ├── scripts
│ │ │ │ ├── generate_aws_provider_resources.py
│ │ │ │ ├── generate_awscc_provider_resources.py
│ │ │ │ └── scrape_aws_terraform_best_practices.py
│ │ │ ├── server.py
│ │ │ └── static
│ │ │ ├── __init__.py
│ │ │ ├── AWS_PROVIDER_RESOURCES.md
│ │ │ ├── AWS_TERRAFORM_BEST_PRACTICES.md
│ │ │ ├── AWSCC_PROVIDER_RESOURCES.md
│ │ │ ├── MCP_INSTRUCTIONS.md
│ │ │ └── TERRAFORM_WORKFLOW_GUIDE.md
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── __init__.py
│ │ │ ├── .gitignore
│ │ │ ├── conftest.py
│ │ │ ├── README.md
│ │ │ ├── test_command_impl.py
│ │ │ ├── test_execute_terraform_command.py
│ │ │ ├── test_execute_terragrunt_command.py
│ │ │ ├── test_models.py
│ │ │ ├── test_parameter_annotations.py
│ │ │ ├── test_resources.py
│ │ │ ├── test_run_checkov_scan.py
│ │ │ ├── test_search_user_provided_module.py
│ │ │ ├── test_server.py
│ │ │ ├── test_tool_implementations.py
│ │ │ ├── test_utils_additional.py
│ │ │ └── test_utils.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── timestream-for-influxdb-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── timestream_for_influxdb_mcp_server
│ │ │ ├── __init__.py
│ │ │ └── server.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_init.py
│ │ │ ├── test_main.py
│ │ │ └── test_server.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ ├── valkey-mcp-server
│ │ ├── .gitignore
│ │ ├── .python-version
│ │ ├── awslabs
│ │ │ ├── __init__.py
│ │ │ └── valkey_mcp_server
│ │ │ ├── __init__.py
│ │ │ ├── common
│ │ │ │ ├── __init__.py
│ │ │ │ ├── config.py
│ │ │ │ ├── connection.py
│ │ │ │ └── server.py
│ │ │ ├── context.py
│ │ │ ├── main.py
│ │ │ ├── tools
│ │ │ │ ├── __init__.py
│ │ │ │ ├── bitmap.py
│ │ │ │ ├── hash.py
│ │ │ │ ├── hyperloglog.py
│ │ │ │ ├── json.py
│ │ │ │ ├── list.py
│ │ │ │ ├── misc.py
│ │ │ │ ├── server_management.py
│ │ │ │ ├── set.py
│ │ │ │ ├── sorted_set.py
│ │ │ │ ├── stream.py
│ │ │ │ └── string.py
│ │ │ └── version.py
│ │ ├── CHANGELOG.md
│ │ ├── docker-healthcheck.sh
│ │ ├── Dockerfile
│ │ ├── ELASTICACHECONNECT.md
│ │ ├── LICENSE
│ │ ├── NOTICE
│ │ ├── pyproject.toml
│ │ ├── README.md
│ │ ├── tests
│ │ │ ├── test_bitmap.py
│ │ │ ├── test_config.py
│ │ │ ├── test_connection.py
│ │ │ ├── test_hash.py
│ │ │ ├── test_hyperloglog.py
│ │ │ ├── test_init.py
│ │ │ ├── test_json_additional.py
│ │ │ ├── test_json_readonly.py
│ │ │ ├── test_json.py
│ │ │ ├── test_list_additional.py
│ │ │ ├── test_list_readonly.py
│ │ │ ├── test_list.py
│ │ │ ├── test_main.py
│ │ │ ├── test_misc.py
│ │ │ ├── test_server_management.py
│ │ │ ├── test_set_readonly.py
│ │ │ ├── test_set.py
│ │ │ ├── test_sorted_set_additional.py
│ │ │ ├── test_sorted_set_readonly.py
│ │ │ ├── test_sorted_set.py
│ │ │ ├── test_stream_additional.py
│ │ │ ├── test_stream_readonly.py
│ │ │ ├── test_stream.py
│ │ │ └── test_string.py
│ │ ├── uv-requirements.txt
│ │ └── uv.lock
│ └── well-architected-security-mcp-server
│ ├── .python-version
│ ├── awslabs
│ │ └── well_architected_security_mcp_server
│ │ ├── __init__.py
│ │ ├── consts.py
│ │ ├── server.py
│ │ └── util
│ │ ├── __init__.py
│ │ ├── network_security.py
│ │ ├── prompt_utils.py
│ │ ├── resource_utils.py
│ │ ├── security_services.py
│ │ └── storage_security.py
│ ├── PROMPT_TEMPLATE.md
│ ├── pyproject.toml
│ ├── README.md
│ ├── tests
│ │ ├── __init__.py
│ │ ├── conftest.py
│ │ ├── README.md
│ │ ├── test_access_analyzer_fix.py
│ │ ├── test_network_security_additional.py
│ │ ├── test_network_security.py
│ │ ├── test_prompt_utils_coverage.py
│ │ ├── test_prompt_utils.py
│ │ ├── test_resource_utils_fix.py
│ │ ├── test_resource_utils.py
│ │ ├── test_security_services_additional.py
│ │ ├── test_security_services_coverage.py
│ │ ├── test_security_services.py
│ │ ├── test_server_additional.py
│ │ ├── test_server_coverage.py
│ │ ├── test_server_prompts.py
│ │ ├── test_server_security_findings.py
│ │ ├── test_server.py
│ │ ├── test_storage_security_additional.py
│ │ ├── test_storage_security_comprehensive.py
│ │ ├── test_storage_security_edge_cases.py
│ │ ├── test_storage_security_recommendations.py
│ │ ├── test_storage_security.py
│ │ └── test_user_agent_config.py
│ └── uv.lock
└── VIBE_CODING_TIPS_TRICKS.md
```
# Files
--------------------------------------------------------------------------------
/src/eks-mcp-server/tests/test_k8s_handler.py:
--------------------------------------------------------------------------------
```python
# 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.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ruff: noqa: D101, D102, D103
"""Tests for the K8sHandler class."""
import os
import pytest
from awslabs.eks_mcp_server.k8s_apis import K8sApis
from awslabs.eks_mcp_server.k8s_handler import K8sHandler
from mcp.server.fastmcp import Context
from mcp.types import TextContent
from unittest.mock import MagicMock, mock_open, patch
@pytest.fixture
def mock_context():
"""Create a mock MCP context."""
ctx = MagicMock(spec=Context)
ctx.request_id = 'test-request-id'
return ctx
@pytest.fixture
def mock_mcp():
"""Create a mock MCP server."""
return MagicMock()
@pytest.fixture
def mock_client_cache():
"""Create a mock K8sClientCache."""
cache = MagicMock()
mock_k8s_apis = MagicMock(spec=K8sApis)
cache.get_client.return_value = mock_k8s_apis
return cache
@pytest.fixture
def mock_k8s_apis():
"""Create a mock K8sApis instance."""
return MagicMock(spec=K8sApis)
class TestK8sHandler:
"""Tests for the K8sHandler class."""
def test_init(self, mock_mcp, mock_client_cache):
"""Test initialization of K8sHandler."""
# Initialize the K8s handler with allow_write=True
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Verify that the handler has the correct attributes
assert handler.mcp == mock_mcp
assert handler.client_cache == mock_client_cache
assert handler.allow_write is True
assert handler.allow_sensitive_data_access is False
# Verify that the tools were registered
assert mock_mcp.tool.call_count == 7
# Get all call args
call_args_list = mock_mcp.tool.call_args_list
# Get all tool names that were registered
tool_names = [call_args[1]['name'] for call_args in call_args_list]
# Verify that expected tools were registered
assert 'list_k8s_resources' in tool_names
assert 'generate_app_manifest' in tool_names
assert 'apply_yaml' in tool_names
assert 'manage_k8s_resource' in tool_names
assert 'get_pod_logs' in tool_names
assert 'get_k8s_events' in tool_names
def test_init_with_sensitive_data_access(self, mock_mcp, mock_client_cache):
"""Test initialization of K8sHandler with sensitive data access enabled."""
# Initialize the K8s handler with sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=False, allow_sensitive_data_access=True)
# Verify that the handler has the correct attributes
assert handler.mcp == mock_mcp
assert handler.client_cache == mock_client_cache
assert handler.allow_write is False
assert handler.allow_sensitive_data_access is True
# Verify that the tools were registered
assert mock_mcp.tool.call_count == 7
# Get all call args
call_args_list = mock_mcp.tool.call_args_list
# Get all tool names that were registered
tool_names = [call_args[1]['name'] for call_args in call_args_list]
# Verify that expected tools were registered
assert 'list_k8s_resources' in tool_names
assert 'get_pod_logs' in tool_names
assert 'get_k8s_events' in tool_names
assert 'list_api_versions' in tool_names
assert 'manage_k8s_resource' in tool_names
assert 'apply_yaml' in tool_names
assert 'generate_app_manifest' in tool_names
def test_get_client(self, mock_mcp, mock_client_cache):
"""Test get_client method delegates to the client cache."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Get a client
client = handler.get_client('test-cluster')
# Verify that get_client was called on the cache
mock_client_cache.get_client.assert_called_once_with('test-cluster')
# Verify that the client was returned
assert client == mock_client_cache.get_client.return_value
def test_load_yaml_template_removes_checkov_annotations(self, mock_mcp, mock_client_cache):
"""Test _load_yaml_template method removes checkov skip annotations from deployment template."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Create mock file content for templates with checkov skip annotations
deployment_template = """apiVersion: apps/v1
kind: Deployment
metadata:
name: APP_NAME
namespace: NAMESPACE
annotations:
checkov.io/skip1: "CKV_K8S_14=We're using a specific image version"
checkov.io/skip2: "CKV_K8S_43=Resource limits are set appropriately"
other-annotation: "This should be preserved"
spec:
replicas: REPLICAS"""
service_template = """apiVersion: v1
kind: Service
metadata:
name: APP_NAME
namespace: NAMESPACE
annotations:
service.beta.kubernetes.io/aws-load-balancer-scheme: LOAD_BALANCER_SCHEME"""
# Mock open to return our test templates
mock_open_func = mock_open()
mock_file = MagicMock()
mock_file.__enter__.return_value.read.side_effect = [deployment_template, service_template]
mock_open_func.return_value = mock_file
# Mock yaml.safe_load and yaml.dump to use real functions
with patch('builtins.open', mock_open_func):
# Test loading and processing templates
template_files = ['deployment.yaml', 'service.yaml']
values = {
'APP_NAME': 'test-app',
'NAMESPACE': 'test-namespace',
'REPLICAS': '3',
'LOAD_BALANCER_SCHEME': 'internal',
}
result = handler._load_yaml_template(template_files, values)
# Verify open was called for each template
assert mock_open_func.call_count == 2
# Verify template content was properly processed
assert 'kind: Deployment' in result
assert 'kind: Service' in result
assert 'name: test-app' in result
assert 'namespace: test-namespace' in result
assert 'replicas: 3' in result
assert 'service.beta.kubernetes.io/aws-load-balancer-scheme: internal' in result
# Verify checkov annotations were removed
assert 'checkov.io/skip1' not in result
assert 'checkov.io/skip2' not in result
# Verify other annotations were preserved
assert 'other-annotation: This should be preserved' in result
@pytest.mark.asyncio
async def test_apply_yaml_relative_path(self, mock_context, mock_mcp, mock_client_cache):
"""Test apply_yaml method with a relative path."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock os.path.isabs to return False for relative paths
with patch('os.path.isabs', return_value=False):
# Apply YAML from a relative path
result = await handler.apply_yaml(
mock_context,
yaml_path='relative/path/to/manifest.yaml',
cluster_name='test-cluster',
namespace='default',
force=True,
)
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert 'Path must be absolute' in result.content[0].text
assert 'relative/path/to/manifest.yaml' in result.content[0].text
@pytest.mark.asyncio
async def test_apply_yaml_success(self, mock_context, mock_mcp, mock_client_cache):
"""Test apply_yaml method with successful application."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock open to read the YAML file
yaml_content = """apiVersion: v1
kind: Namespace
metadata:
name: test-namespace
"""
with patch('builtins.open', mock_open(read_data=yaml_content)) as mocked_open:
# Mock apply_from_yaml
mock_k8s_apis.apply_from_yaml.return_value = ([], 1, 0)
# Apply YAML from file
result = await handler.apply_yaml(
mock_context,
yaml_path='/path/to/manifest.yaml',
cluster_name='test-cluster',
namespace='default',
force=True,
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that open was called with the correct path
mocked_open.assert_called_once_with('/path/to/manifest.yaml', 'r')
# Verify that apply_from_yaml was called with the correct parameters
mock_k8s_apis.apply_from_yaml.assert_called_once()
args, kwargs = mock_k8s_apis.apply_from_yaml.call_args
assert len(kwargs['yaml_objects']) == 1
assert kwargs['yaml_objects'][0]['kind'] == 'Namespace'
assert kwargs['namespace'] == 'default'
assert kwargs['force'] is True
# Verify the result
assert not result.isError
assert isinstance(result.content[0], TextContent)
assert (
'Successfully applied all resources from YAML file'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_apply_yaml_file_not_found(self, mock_context, mock_mcp, mock_client_cache):
"""Test apply_yaml method with file not found error."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock open to raise FileNotFoundError
with patch('builtins.open', side_effect=FileNotFoundError()):
# Apply YAML from file
result = await handler.apply_yaml(
mock_context,
yaml_path='/path/to/nonexistent.yaml',
cluster_name='test-cluster',
namespace='default',
force=True,
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert 'YAML file not found' in result.content[0].text
@pytest.mark.asyncio
async def test_apply_yaml_io_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test apply_yaml method with IO error."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock open to raise IOError
with patch('builtins.open', side_effect=IOError('Permission denied')):
# Apply YAML from file
result = await handler.apply_yaml(
mock_context,
yaml_path='/path/to/protected.yaml',
cluster_name='test-cluster',
namespace='default',
force=True,
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert 'Error reading YAML file' in result.content[0].text
assert 'Permission denied' in result.content[0].text
@pytest.mark.asyncio
async def test_apply_yaml_create_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test apply_yaml method with error from create_from_yaml."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
with patch.object(handler, 'get_client', return_value=mock_k8s_apis):
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock open to read the YAML file
yaml_content = """apiVersion: v1
kind: Namespace
metadata:
name: test-namespace
"""
with patch('builtins.open', mock_open(read_data=yaml_content)):
# Mock apply_from_yaml to raise an exception
mock_k8s_apis.apply_from_yaml.side_effect = Exception(
'Failed to create resource'
)
# Apply YAML from file
result = await handler.apply_yaml(
mock_context,
yaml_path='/path/to/manifest.yaml',
cluster_name='test-cluster',
namespace='default',
force=True,
)
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert 'Failed to apply YAML from file' in result.content[0].text
assert 'Failed to create resource' in result.content[0].text
# Note: TTL cache expiration tests have been moved to test_k8s_client_cache.py
@pytest.mark.asyncio
async def test_manage_k8s_resource_create(self, mock_context, mock_mcp, mock_client_cache):
"""Test manage_k8s_resource method with create operation."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Mock the get_client method and k8s_apis.manage_resource
mock_k8s_apis = MagicMock()
mock_response = MagicMock()
mock_response.to_dict.return_value = {
'kind': 'Pod',
'apiVersion': 'v1',
'metadata': {'name': 'test-pod', 'namespace': 'test-namespace'},
}
mock_k8s_apis.manage_resource.return_value = mock_response
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Create a test resource
body = {
'metadata': {'name': 'test-pod'},
'spec': {'containers': [{'name': 'test-container', 'image': 'nginx'}]},
}
result = await handler.manage_k8s_resource(
mock_context,
operation='create',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
body=body,
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that manage_resource was called with the correct parameters
mock_k8s_apis.manage_resource.assert_called_once()
# Verify the result
assert not result.isError
assert result.kind == 'Pod'
assert result.name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'create'
assert isinstance(result.content[0], TextContent)
assert 'Successfully created Pod test-namespace/test-pod' in result.content[0].text
@pytest.mark.asyncio
async def test_read_k8s_resource(self, mock_context, mock_mcp, mock_client_cache):
"""Test read_k8s_resource method."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock the get_client method and k8s_apis.manage_resource
mock_k8s_apis = MagicMock()
mock_response = MagicMock()
mock_response.to_dict.return_value = {
'kind': 'Pod',
'apiVersion': 'v1',
'metadata': {'name': 'test-pod', 'namespace': 'test-namespace'},
}
mock_k8s_apis.manage_resource.return_value = mock_response
with patch.object(handler, 'get_client', return_value=mock_k8s_apis):
result = await handler.manage_k8s_resource(
mock_context,
operation='read',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
)
# Verify the result
assert not result.isError
assert result.kind == 'Pod'
assert result.name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'read'
assert result.resource is not None
assert isinstance(result.content[0], TextContent)
assert 'Successfully retrieved Pod test-namespace/test-pod' in result.content[0].text
@pytest.mark.asyncio
async def test_manage_k8s_resource_invalid_operation(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test manage_k8s_resource method with an invalid operation."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Call manage_k8s_resource with an invalid operation
result = await handler.manage_k8s_resource(
mock_context,
operation='invalid',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
)
# Verify the result
assert result.isError
assert result.kind == 'Pod'
assert result.name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'invalid'
assert isinstance(result.content[0], TextContent)
assert 'Invalid operation: invalid' in result.content[0].text
@pytest.mark.asyncio
async def test_manage_k8s_resource_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test manage_k8s_resource method with an error."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.manage_resource.side_effect = Exception('Resource not found')
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
result = await handler.manage_k8s_resource(
mock_context,
operation='read',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that manage_resource was called with the correct parameters
mock_k8s_apis.manage_resource.assert_called_once()
# Verify the result
assert result.isError
assert result.kind == 'Pod'
assert result.name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'read'
assert isinstance(result.content[0], TextContent)
assert (
'Failed to read Pod test-namespace/test-pod: Resource not found'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_manage_k8s_resource_secret_sensitive_data_access_disabled(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test manage_k8s_resource method with Secret kind and sensitive data access disabled."""
# Initialize the K8s handler with sensitive data access disabled but write access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True, allow_sensitive_data_access=False)
# Test with read operation on Secret (should be rejected)
result = await handler.manage_k8s_resource(
mock_context,
operation='read',
cluster_name='test-cluster',
kind='Secret',
api_version='v1',
name='test-secret',
namespace='test-namespace',
)
# Verify the result
assert result.isError
assert result.kind == 'Secret'
assert result.name == 'test-secret'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'read'
assert isinstance(result.content[0], TextContent)
assert (
'Access to Kubernetes Secrets requires --allow-sensitive-data-access flag'
in result.content[0].text
)
# Test with create operation on Secret (should be rejected for sensitive data access, not write access)
result = await handler.manage_k8s_resource(
mock_context,
operation='create',
cluster_name='test-cluster',
kind='Secret',
api_version='v1',
name='test-secret',
namespace='test-namespace',
body={'metadata': {'name': 'test-secret'}, 'data': {'key': 'dmFsdWU='}},
)
# Verify the result
assert not result.isError
assert result.kind == 'Secret'
assert result.name == 'test-secret'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'create'
assert isinstance(result.content[0], TextContent)
@pytest.mark.asyncio
async def test_manage_k8s_resource_write_access_disabled(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test manage_k8s_resource method with write access disabled for mutable operations."""
# Initialize the K8s handler with write access disabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=False)
# Test with create operation (should be rejected)
result = await handler.manage_k8s_resource(
mock_context,
operation='create',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
body={'metadata': {'name': 'test-pod'}},
)
# Verify the result
assert result.isError
assert result.kind == 'Pod'
assert result.name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'create'
assert isinstance(result.content[0], TextContent)
assert 'Operation create is not allowed without write access' in result.content[0].text
# Test with replace operation (should be rejected when write access is disabled)
result = await handler.manage_k8s_resource(
mock_context,
operation='replace',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
body={'metadata': {'name': 'test-pod'}},
)
# Verify the result
assert result.isError
assert result.operation == 'replace'
assert isinstance(result.content[0], TextContent)
assert 'Operation replace is not allowed without write access' in result.content[0].text
# Test with patch operation (should be rejected when write access is disabled)
result = await handler.manage_k8s_resource(
mock_context,
operation='patch',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
body={'metadata': {'labels': {'app': 'test'}}},
)
# Verify the result
assert result.isError
assert result.operation == 'patch'
assert isinstance(result.content[0], TextContent)
assert 'Operation patch is not allowed without write access' in result.content[0].text
# Test with delete operation (should be rejected when write access is disabled)
result = await handler.manage_k8s_resource(
mock_context,
operation='delete',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
)
# Verify the result
assert result.isError
assert result.operation == 'delete'
assert isinstance(result.content[0], TextContent)
assert 'Operation delete is not allowed without write access' in result.content[0].text
# Test with read operation (should be allowed even when write access is disabled)
mock_k8s_apis = MagicMock()
mock_response = MagicMock()
mock_response.to_dict.return_value = {
'kind': 'Pod',
'apiVersion': 'v1',
'metadata': {'name': 'test-pod', 'namespace': 'test-namespace'},
}
mock_k8s_apis.manage_resource.return_value = mock_response
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
result = await handler.manage_k8s_resource(
mock_context,
operation='read',
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
name='test-pod',
namespace='test-namespace',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that manage_resource was called
mock_k8s_apis.manage_resource.assert_called_once()
# Verify the result
assert not result.isError
assert result.kind == 'Pod'
assert result.name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.api_version == 'v1'
assert result.operation == 'read'
assert isinstance(result.content[0], TextContent)
assert 'Successfully retrieved Pod test-namespace/test-pod' in result.content[0].text
@pytest.mark.asyncio
async def test_list_k8s_resources_success(self, mock_context, mock_mcp, mock_client_cache):
"""Test list_k8s_resources method with successful listing."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
# Mock response with items
mock_item1 = MagicMock()
mock_item1.to_dict.return_value = {
'metadata': {
'name': 'test-pod-1',
'namespace': 'test-namespace',
'creation_timestamp': '2023-01-01T00:00:00Z',
'labels': {'app': 'test'},
'annotations': {'description': 'Test pod 1'},
}
}
mock_item2 = MagicMock()
mock_item2.to_dict.return_value = {
'metadata': {
'name': 'test-pod-2',
'namespace': 'test-namespace',
'creation_timestamp': '2023-01-02T00:00:00Z',
'labels': {'app': 'test'},
'annotations': {'description': 'Test pod 2'},
}
}
mock_response = MagicMock()
mock_response.items = [mock_item1, mock_item2]
mock_k8s_apis.list_resources.return_value = mock_response
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
result = await handler.list_k8s_resources(
mock_context,
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
namespace='test-namespace',
label_selector='app=test',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that list_resources was called once
mock_k8s_apis.list_resources.assert_called_once()
# Get the call args
args, kwargs = mock_k8s_apis.list_resources.call_args
# Verify the positional args
assert args[0] == 'Pod'
assert args[1] == 'v1'
# Verify the keyword args
assert kwargs['namespace'] == 'test-namespace'
assert kwargs['label_selector'] == 'app=test'
# Verify the result
assert not result.isError
assert result.kind == 'Pod'
assert result.api_version == 'v1'
assert result.namespace == 'test-namespace'
assert result.count == 2
assert len(result.items) == 2
assert result.items[0].name == 'test-pod-1'
assert result.items[0].namespace == 'test-namespace'
# Don't check creation_timestamp as it might be None in the actual implementation
assert result.items[0].labels == {'app': 'test'}
assert result.items[0].annotations == {'description': 'Test pod 1'}
assert result.items[1].name == 'test-pod-2'
assert isinstance(result.content[0], TextContent)
assert (
'Successfully listed 2 Pod resources in test-namespace/' in result.content[0].text
)
@pytest.mark.asyncio
async def test_list_k8s_resources_empty(self, mock_context, mock_mcp, mock_client_cache):
"""Test list_k8s_resources method with empty result."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
# Mock response with no items
mock_response = MagicMock()
mock_response.items = []
mock_k8s_apis.list_resources.return_value = mock_response
with patch.object(handler, 'get_client', return_value=mock_k8s_apis):
result = await handler.list_k8s_resources(
mock_context,
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
namespace='test-namespace',
)
# Verify the result
assert not result.isError
assert result.kind == 'Pod'
assert result.count == 0
assert len(result.items) == 0
assert isinstance(result.content[0], TextContent)
assert (
'Successfully listed 0 Pod resources in test-namespace/' in result.content[0].text
)
@pytest.mark.asyncio
async def test_list_k8s_resources_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test list_k8s_resources method with an error."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.list_resources.side_effect = Exception('Failed to list resources')
with patch.object(handler, 'get_client', return_value=mock_k8s_apis):
result = await handler.list_k8s_resources(
mock_context,
cluster_name='test-cluster',
kind='Pod',
api_version='v1',
namespace='test-namespace',
)
# Verify the result
assert result.isError
assert result.kind == 'Pod'
assert result.count == 0
assert len(result.items) == 0
assert isinstance(result.content[0], TextContent)
assert (
'Failed to list Pod resources: Failed to list resources' in result.content[0].text
)
@pytest.mark.asyncio
async def test_generate_app_manifest_write_access_disabled(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test generate_app_manifest method with write access disabled."""
# Initialize the K8s handler with write access disabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=False)
# Generate manifest with write access disabled
result = await handler.generate_app_manifest(
mock_context,
app_name='test-app',
image_uri='123456789012.dkr.ecr.region.amazonaws.com/repo:tag',
output_dir='/absolute/path/to/output',
)
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert (
'Operation generate_app_manifest is not allowed without write access'
in result.content[0].text
)
assert result.output_file_path == ''
@pytest.mark.asyncio
async def test_generate_app_manifest_relative_path(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test generate_app_manifest method with a relative path."""
# Initialize the K8s handler with write access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Mock os.path.isabs to return False for relative paths
with patch('os.path.isabs', return_value=False):
# Generate manifest with a relative path
result = await handler.generate_app_manifest(
mock_context,
app_name='test-app',
image_uri='123456789012.dkr.ecr.region.amazonaws.com/repo:tag',
output_dir='relative/path/to/output',
)
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert 'Output directory path must be absolute' in result.content[0].text
assert 'relative/path/to/output' in result.content[0].text
@pytest.mark.asyncio
async def test_generate_app_manifest_success(self, mock_context, mock_mcp, mock_client_cache):
"""Test generate_app_manifest with successful creation."""
# Initialize the K8s handler with write access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Mock the _load_yaml_template method to avoid template loading issues
with patch.object(handler, '_load_yaml_template', return_value='combined yaml content'):
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock os.makedirs to avoid creating directories
with patch('os.makedirs') as mock_makedirs:
# Mock open for writing output
with patch('builtins.open', mock_open()) as mocked_open:
# Mock os.path.abspath to return a predictable absolute path
with patch(
'os.path.abspath',
return_value='/absolute/path/test-output/test-app-manifest.yaml',
):
# Generate the manifest
result = await handler.generate_app_manifest(
mock_context,
app_name='test-app',
image_uri='123456789012.dkr.ecr.region.amazonaws.com/repo:tag',
port=8080,
replicas=3,
cpu='250m',
memory='256Mi',
namespace='test-namespace',
load_balancer_scheme='internet-facing',
output_dir='/absolute/path/test-output',
)
# Verify that os.makedirs was called with exist_ok=True
mock_makedirs.assert_called_once_with(
'/absolute/path/test-output', exist_ok=True
)
# Verify that open was called for writing output
mocked_open.assert_called_once_with(
'/absolute/path/test-output/test-app-manifest.yaml', 'w'
)
# Verify the result
assert not result.isError
assert isinstance(result.content[0], TextContent)
assert (
'Successfully generated YAML for test-app'
in result.content[0].text
)
assert (
'with image 123456789012.dkr.ecr.region.amazonaws.com/repo:tag'
in result.content[0].text
)
# Verify that the output path is absolute
assert os.path.isabs(result.output_file_path)
assert (
result.output_file_path
== '/absolute/path/test-output/test-app-manifest.yaml'
)
@pytest.mark.asyncio
async def test_generate_app_manifest_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test generate_app_manifest with an error."""
# Initialize the K8s handler with write access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock open function to raise an exception
with patch('builtins.open', side_effect=Exception('File error')):
# Generate the manifest with an absolute path
result = await handler.generate_app_manifest(
mock_context,
app_name='test-app',
image_uri='123456789012.dkr.ecr.region.amazonaws.com/repo:tag',
output_dir='/absolute/path/to/output', # Use an absolute path
)
# Verify the result
assert result.isError
assert isinstance(result.content[0], TextContent)
assert 'Failed to generate YAML' in result.content[0].text
assert 'File error' in result.content[0].text
assert result.output_file_path == ''
def test_load_yaml_template(self, mock_mcp, mock_client_cache):
"""Test _load_yaml_template method."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Create mock file content for templates
template1 = 'kind: Deployment\nmetadata:\n name: APP_NAME'
template2 = 'kind: Service\nmetadata:\n name: APP_NAME'
# Mock open to return our test templates
mock_open = MagicMock()
mock_file = MagicMock()
mock_file.__enter__.return_value.read.side_effect = [template1, template2]
mock_open.return_value = mock_file
with patch('builtins.open', mock_open):
# Test loading and processing templates
template_files = ['file1.yaml', 'file2.yaml']
values = {'APP_NAME': 'test-app'}
result = handler._load_yaml_template(template_files, values)
# Verify open was called for each template
assert mock_open.call_count == 2
# Verify template content was properly processed
assert 'kind: Deployment' in result
assert 'kind: Service' in result
assert 'name: test-app' in result
assert '---' in result
@pytest.mark.asyncio
async def test_generate_app_manifest_with_absolute_path(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test generate_app_manifest with an absolute path."""
# Initialize the K8s handler with write access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Mock the _load_yaml_template method to avoid template loading issues
with patch.object(handler, '_load_yaml_template', return_value='combined yaml content'):
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock os.makedirs to avoid creating directories
with patch('os.makedirs') as mock_makedirs:
# Mock open for writing output
with patch('builtins.open', mock_open()) as mocked_open:
# Mock os.path.abspath to return a predictable absolute path
with patch(
'os.path.abspath',
return_value='/path/to/output/test-app-manifest.yaml',
):
# Generate the manifest with an absolute path
result = await handler.generate_app_manifest(
mock_context,
app_name='test-app',
image_uri='123456789012.dkr.ecr.region.amazonaws.com/repo:tag',
output_dir='/path/to/output',
)
# Verify that os.makedirs was called with exist_ok=True
mock_makedirs.assert_called_once_with('/path/to/output', exist_ok=True)
# Verify that open was called for writing output
mocked_open.assert_called_once_with(
'/path/to/output/test-app-manifest.yaml', 'w'
)
# Verify the output file path is absolute
assert os.path.isabs(result.output_file_path)
assert (
result.output_file_path == '/path/to/output/test-app-manifest.yaml'
)
# Verify the result is successful
assert not result.isError
@pytest.mark.asyncio
async def test_generate_app_manifest_multiple_templates(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test generate_app_manifest with multiple templates."""
# Initialize the K8s handler with write access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=True)
# Mock the _load_yaml_template method to avoid template loading issues
with patch.object(handler, '_load_yaml_template', return_value='combined yaml content'):
# Mock os.path.isabs to return True for absolute paths
with patch('os.path.isabs', return_value=True):
# Mock os.makedirs to avoid creating directories
with patch('os.makedirs') as mock_makedirs:
# Mock open for writing output
with patch('builtins.open', mock_open()) as mocked_open:
# Mock os.path.abspath to return a predictable absolute path
with patch(
'os.path.abspath',
return_value='/absolute/path/output/test-app-manifest.yaml',
):
# Generate the manifest with all required parameters explicitly specified
result = await handler.generate_app_manifest(
mock_context,
app_name='test-app',
image_uri='123456789012.dkr.ecr.region.amazonaws.com/repo:tag',
port=80,
replicas=2,
cpu='100m',
memory='128Mi',
namespace='default',
load_balancer_scheme='internal', # Using the default value
output_dir='/absolute/path/output',
)
# Verify that os.makedirs was called with exist_ok=True
mock_makedirs.assert_called_once_with(
'/absolute/path/output', exist_ok=True
)
# Verify that open was called for writing output
mocked_open.assert_called_once_with(
'/absolute/path/output/test-app-manifest.yaml', 'w'
)
# Verify the output file path is absolute
assert os.path.isabs(result.output_file_path)
assert (
result.output_file_path
== '/absolute/path/output/test-app-manifest.yaml'
)
# Verify the result is successful
assert not result.isError
def test_init_with_get_pod_logs(self, mock_mcp, mock_client_cache):
"""Test initialization of K8sHandler with get_pod_logs tool."""
# Initialize the K8s handler with both write and sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
K8sHandler(mock_mcp, allow_write=True, allow_sensitive_data_access=True)
# Verify that the tools were registered
assert mock_mcp.tool.call_count == 7
# Get all call args
call_args_list = mock_mcp.tool.call_args_list
# Get all tool names that were registered
tool_names = [call_args[1]['name'] for call_args in call_args_list]
# Verify that get_pod_logs and get_k8s_events were registered
assert 'get_pod_logs' in tool_names
assert 'get_k8s_events' in tool_names
def test_init_write_access_disabled(self, mock_mcp, mock_client_cache):
"""Test initialization of K8sHandler with write access disabled."""
# Initialize the K8s handler with write access disabled but sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_write=False, allow_sensitive_data_access=True)
# Verify that allow_write is set
assert handler.allow_write is False
# Verify that the tools were registered
assert mock_mcp.tool.call_count == 7
# Get all call args
call_args_list = mock_mcp.tool.call_args_list
# Get all tool names that were registered
tool_names = [call_args[1]['name'] for call_args in call_args_list]
# Verify that all tools are registered
assert 'list_k8s_resources' in tool_names
assert 'get_pod_logs' in tool_names
assert 'get_k8s_events' in tool_names
assert 'manage_k8s_resource' in tool_names
assert 'apply_yaml' in tool_names
assert 'generate_app_manifest' in tool_names
@pytest.mark.asyncio
async def test_get_pod_logs_success(self, mock_context, mock_mcp, mock_client_cache):
"""Test get_pod_logs method with successful log retrieval."""
# Initialize the K8s handler with sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=True)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.get_pod_logs.return_value = 'log line 1\nlog line 2\n'
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Get pod logs
result = await handler.get_pod_logs(
mock_context,
cluster_name='test-cluster',
namespace='test-namespace',
pod_name='test-pod',
container_name='test-container',
since_seconds=60,
tail_lines=100,
limit_bytes=1024,
previous=True,
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that get_pod_logs was called with the correct parameters
mock_k8s_apis.get_pod_logs.assert_called_once_with(
pod_name='test-pod',
namespace='test-namespace',
container_name='test-container',
since_seconds=60,
tail_lines=100,
limit_bytes=1024,
previous=True,
)
# Verify the result
assert not result.isError
assert result.pod_name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.container_name == 'test-container'
assert result.log_lines == ['log line 1', 'log line 2', '']
assert isinstance(result.content[0], TextContent)
assert (
'Successfully retrieved 3 log lines from pod test-namespace/test-pod (container: test-container)'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_pod_logs_minimal(self, mock_context, mock_mcp, mock_client_cache):
"""Test get_pod_logs method with minimal parameters."""
# Initialize the K8s handler with sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=True)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.get_pod_logs.return_value = 'log line 1\nlog line 2\n'
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Get pod logs with minimal parameters - explicitly pass default values for non-optional parameters
result = await handler.get_pod_logs(
mock_context,
cluster_name='test-cluster',
namespace='test-namespace',
pod_name='test-pod',
container_name=None,
since_seconds=None,
tail_lines=100, # Default value
limit_bytes=10240, # Default value
previous=False, # Default value
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that get_pod_logs was called
mock_k8s_apis.get_pod_logs.assert_called_once()
# Get the call args
args, kwargs = mock_k8s_apis.get_pod_logs.call_args
# Verify the keyword args
assert kwargs['pod_name'] == 'test-pod'
assert kwargs['namespace'] == 'test-namespace'
assert kwargs['container_name'] is None
# Verify the result
assert not result.isError
assert result.pod_name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.container_name is None
assert result.log_lines == ['log line 1', 'log line 2', '']
assert isinstance(result.content[0], TextContent)
assert (
'Successfully retrieved 3 log lines from pod test-namespace/test-pod'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_pod_logs_sensitive_data_access_disabled(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test get_pod_logs method with sensitive data access disabled."""
# Initialize the K8s handler with sensitive data access disabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=False)
# Get pod logs with sensitive data access disabled
result = await handler.get_pod_logs(
mock_context,
cluster_name='test-cluster',
namespace='test-namespace',
pod_name='test-pod',
container_name='test-container',
)
# Verify the result
assert result.isError
assert result.pod_name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.container_name == 'test-container'
assert result.log_lines == []
assert isinstance(result.content[0], TextContent)
assert (
'Access to pod logs requires --allow-sensitive-data-access flag'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_pod_logs_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test get_pod_logs method with an error."""
# Initialize the K8s handler with sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=True)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.get_pod_logs.side_effect = Exception('Pod not found')
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Get pod logs with an error
result = await handler.get_pod_logs(
mock_context,
cluster_name='test-cluster',
namespace='test-namespace',
pod_name='test-pod',
container_name='test-container',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that get_pod_logs was called
mock_k8s_apis.get_pod_logs.assert_called_once()
# Get the call args
args, kwargs = mock_k8s_apis.get_pod_logs.call_args
# Verify the keyword args
assert kwargs['pod_name'] == 'test-pod'
assert kwargs['namespace'] == 'test-namespace'
assert kwargs['container_name'] == 'test-container'
# Verify the result
assert result.isError
assert result.pod_name == 'test-pod'
assert result.namespace == 'test-namespace'
assert result.container_name == 'test-container'
assert result.log_lines == []
assert isinstance(result.content[0], TextContent)
assert (
'Failed to get logs from pod test-namespace/test-pod (container: test-container): Pod not found'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_k8s_events_success(self, mock_context, mock_mcp, mock_client_cache):
"""Test get_k8s_events method with successful event retrieval."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=True)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.get_events.return_value = [
{
'first_timestamp': '2023-01-01T00:00:00Z',
'last_timestamp': '2023-01-01T00:05:00Z',
'count': 5,
'message': 'Container created',
'reason': 'Created',
'reporting_component': 'kubelet',
'type': 'Normal',
},
{
'first_timestamp': '2023-01-01T00:05:00Z',
'last_timestamp': '2023-01-01T00:10:00Z',
'count': 1,
'message': 'Container started',
'reason': 'Started',
'reporting_component': 'kubelet',
'type': 'Normal',
},
]
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Get events
result = await handler.get_k8s_events(
mock_context,
cluster_name='test-cluster',
kind='Pod',
name='test-pod',
namespace='test-namespace',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that get_events was called with the correct parameters
mock_k8s_apis.get_events.assert_called_once_with(
kind='Pod',
name='test-pod',
namespace='test-namespace',
)
# Verify the result
assert not result.isError
assert result.involved_object_kind == 'Pod'
assert result.involved_object_name == 'test-pod'
assert result.involved_object_namespace == 'test-namespace'
assert result.count == 2
assert len(result.events) == 2
# Check first event
assert result.events[0].first_timestamp == '2023-01-01T00:00:00Z'
assert result.events[0].last_timestamp == '2023-01-01T00:05:00Z'
assert result.events[0].count == 5
assert result.events[0].message == 'Container created'
assert result.events[0].reason == 'Created'
assert result.events[0].reporting_component == 'kubelet'
assert result.events[0].type == 'Normal'
# Check second event
assert result.events[1].message == 'Container started'
# Check content
assert isinstance(result.content[0], TextContent)
assert (
'Successfully retrieved 2 events for Pod test-namespace/test-pod'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_k8s_events_empty(self, mock_context, mock_mcp, mock_client_cache):
"""Test get_k8s_events method with no events found."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=True)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.get_events.return_value = []
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Get events
result = await handler.get_k8s_events(
mock_context,
cluster_name='test-cluster',
kind='Pod',
name='test-pod',
namespace='test-namespace',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that get_events was called
mock_k8s_apis.get_events.assert_called_once()
# Verify the result
assert not result.isError
assert result.involved_object_kind == 'Pod'
assert result.involved_object_name == 'test-pod'
assert result.involved_object_namespace == 'test-namespace'
assert result.count == 0
assert len(result.events) == 0
assert isinstance(result.content[0], TextContent)
assert (
'Successfully retrieved 0 events for Pod test-namespace/test-pod'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_k8s_events_sensitive_data_access_disabled(
self, mock_context, mock_mcp, mock_client_cache
):
"""Test get_k8s_events method with sensitive data access disabled."""
# Initialize the K8s handler with sensitive data access disabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=False)
# Get events with sensitive data access disabled
result = await handler.get_k8s_events(
mock_context,
cluster_name='test-cluster',
kind='Pod',
name='test-pod',
namespace='test-namespace',
)
# Verify the result
assert result.isError
assert result.involved_object_kind == 'Pod'
assert result.involved_object_name == 'test-pod'
assert result.involved_object_namespace == 'test-namespace'
assert result.count == 0
assert len(result.events) == 0
assert isinstance(result.content[0], TextContent)
assert (
'Access to Kubernetes events requires --allow-sensitive-data-access flag'
in result.content[0].text
)
@pytest.mark.asyncio
async def test_get_k8s_events_error(self, mock_context, mock_mcp, mock_client_cache):
"""Test get_k8s_events method with an error."""
# Initialize the K8s handler with sensitive data access enabled
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp, allow_sensitive_data_access=True)
# Mock get_client
mock_k8s_apis = MagicMock()
mock_k8s_apis.get_events.side_effect = Exception('Failed to get events')
with patch.object(handler, 'get_client', return_value=mock_k8s_apis) as mock_client:
# Get events with an error
result = await handler.get_k8s_events(
mock_context,
cluster_name='test-cluster',
kind='Pod',
name='test-pod',
namespace='test-namespace',
)
# Verify that get_client was called
mock_client.assert_called_once_with('test-cluster')
# Verify that get_events was called
mock_k8s_apis.get_events.assert_called_once()
# Verify the result
assert result.isError
assert result.involved_object_kind == 'Pod'
assert result.involved_object_name == 'test-pod'
assert result.involved_object_namespace == 'test-namespace'
assert result.count == 0
assert len(result.events) == 0
assert isinstance(result.content[0], TextContent)
assert (
'Failed to get events for Pod test-namespace/test-pod: Failed to get events'
in result.content[0].text
)
def test_remove_managed_fields(self, mock_mcp, mock_client_cache):
"""Test remove_managed_fields method for removing managed_fields from Kubernetes resources."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Create a deep copy of the input to avoid modifying the original
import copy
# Test case 1: Resource with managedFields (camelCase as used by dynamic client)
resource_with_managed_fields = {
'metadata': {
'name': 'test-pod',
'namespace': 'default',
'managedFields': [
{
'manager': 'kubectl',
'operation': 'Update',
'apiVersion': 'v1',
'time': '2023-01-01T00:00:00Z',
'fieldsType': 'FieldsV1',
'fieldsV1': {'f:metadata': {'f:labels': {'.': {}, 'f:app': {}}}},
}
],
},
'spec': {'containers': [{'name': 'container1', 'image': 'nginx'}]},
}
expected_result = {
'metadata': {'name': 'test-pod', 'namespace': 'default'},
'spec': {'containers': [{'name': 'container1', 'image': 'nginx'}]},
}
# Make a deep copy to avoid modifying the original
input_copy = copy.deepcopy(resource_with_managed_fields)
result = handler.remove_managed_fields(input_copy)
assert result == expected_result
# Test case 2: Resource without managedFields
resource_without_managed_fields = {
'metadata': {'name': 'test-pod', 'namespace': 'default'},
'spec': {'containers': [{'name': 'container1', 'image': 'nginx'}]},
}
# The result should be the same as the input
result = handler.remove_managed_fields(resource_without_managed_fields)
assert result == resource_without_managed_fields
# Test case 3: Resource without metadata
resource_without_metadata = {
'kind': 'Pod',
'apiVersion': 'v1',
'spec': {'containers': [{'name': 'container1', 'image': 'nginx'}]},
}
# The result should be the same as the input
result = handler.remove_managed_fields(resource_without_metadata)
assert result == resource_without_metadata
# Test case 4: Non-dict input
non_dict_input = {} # Use empty dict instead of string to avoid type error
result = handler.remove_managed_fields(non_dict_input)
assert result == non_dict_input
def test_cleanup_resource_response(self, mock_mcp, mock_client_cache):
"""Test cleanup_resource_response method for removing managed fields and null values."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Create a complex resource with both managed_fields and null values
complex_resource = {
'kind': 'Pod',
'apiVersion': 'v1',
'metadata': {
'name': 'test-pod',
'namespace': 'default',
'managedFields': [
{
'manager': 'kubectl',
'operation': 'Update',
'apiVersion': 'v1',
'time': '2023-01-01T00:00:00Z',
'fieldsType': 'FieldsV1',
'fieldsV1': {'f:metadata': {'f:labels': {'.': {}, 'f:app': {}}}},
}
],
'labels': {'app': 'test', 'environment': None},
'annotations': None,
},
'spec': {
'containers': [
{'name': 'container1', 'image': 'nginx', 'resources': None},
None,
{
'name': 'container2',
'image': 'redis',
'ports': [{'containerPort': 6379}, {'containerPort': None}],
},
],
'volumes': None,
},
'status': None,
}
# Expected result after cleanup
expected_result = {
'kind': 'Pod',
'apiVersion': 'v1',
'metadata': {'name': 'test-pod', 'namespace': 'default', 'labels': {'app': 'test'}},
'spec': {
'containers': [
{'name': 'container1', 'image': 'nginx'},
{
'name': 'container2',
'image': 'redis',
'ports': [{'containerPort': 6379}, {}],
},
]
},
}
# Test with spies to verify both methods are called
with patch.object(
handler, 'remove_managed_fields', wraps=handler.remove_managed_fields
) as mock_remove:
with patch.object(
handler, 'filter_null_values', wraps=handler.filter_null_values
) as mock_filter:
result = handler.cleanup_resource_response(complex_resource)
# Verify that both methods were called
mock_remove.assert_called_once_with(complex_resource)
# We don't check the exact number of calls for filter_null_values since it's recursive
# and will be called for each nested element
assert mock_filter.called
# Just verify that filter_null_values was called at least once
# We can't easily check the exact argument since remove_managed_fields modifies the input
# Verify the final result
assert result == expected_result
# Test with a simple string input
simple_input = 'simple string'
result = handler.cleanup_resource_response(simple_input)
assert result == simple_input
def test_remove_checkov_skip_annotations(self, mock_mcp, mock_client_cache):
"""Test _remove_checkov_skip_annotations method directly to ensure line 807 is covered."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Test case 1: YAML with only checkov skip annotations (should remove annotations completely)
yaml_content = """apiVersion: apps/v1
kind: Deployment
metadata:
name: test-app
namespace: default
annotations:
checkov.io/skip1: "CKV_K8S_14=We're using a specific image version"
checkov.io/skip2: "CKV_K8S_43=Resource limits are set appropriately"
spec:
replicas: 3"""
expected_result = """apiVersion: apps/v1
kind: Deployment
metadata:
name: test-app
namespace: default
spec:
replicas: 3
"""
result = handler._remove_checkov_skip_annotations(yaml_content)
# Normalize whitespace for comparison
result = result.replace(' ', '').replace('\n', '')
expected_result = expected_result.replace(' ', '').replace('\n', '')
assert result == expected_result
# Test case 2: YAML with mixed annotations (should keep non-checkov annotations)
yaml_content = """apiVersion: apps/v1
kind: Deployment
metadata:
name: test-app
namespace: default
annotations:
checkov.io/skip1: "CKV_K8S_14=We're using a specific image version"
other-annotation: "This should be preserved"
spec:
replicas: 3"""
expected_result = """apiVersion: apps/v1
kind: Deployment
metadata:
name: test-app
namespace: default
annotations:
other-annotation: This should be preserved
spec:
replicas: 3
"""
result = handler._remove_checkov_skip_annotations(yaml_content)
assert 'other-annotation: This should be preserved' in result
def test_filter_null_values(self, mock_mcp, mock_client_cache):
"""Test filter_null_values method for removing null values from data structures."""
# Initialize the K8s handler
with patch(
'awslabs.eks_mcp_server.k8s_handler.K8sClientCache', return_value=mock_client_cache
):
handler = K8sHandler(mock_mcp)
# Test case 1: Simple dictionary with null values
input_dict = {'key1': 'value1', 'key2': None, 'key3': 'value3', 'key4': None}
expected_dict = {'key1': 'value1', 'key3': 'value3'}
result = handler.filter_null_values(input_dict)
assert result == expected_dict
# Test case 2: Nested dictionary with null values
input_nested_dict = {
'key1': 'value1',
'key2': None,
'key3': {
'nested1': 'nested_value1',
'nested2': None,
'nested3': {'deep1': 'deep_value1', 'deep2': None},
},
}
expected_nested_dict = {
'key1': 'value1',
'key3': {'nested1': 'nested_value1', 'nested3': {'deep1': 'deep_value1'}},
}
result = handler.filter_null_values(input_nested_dict)
assert result == expected_nested_dict
# Test case 3: List with null values
input_list = ['item1', None, 'item2', None, 'item3']
expected_list = ['item1', 'item2', 'item3']
result = handler.filter_null_values(input_list)
assert result == expected_list
# Test case 4: List of dictionaries with null values
input_list_of_dicts = [
{'key1': 'value1', 'key2': None},
None,
{'key3': None, 'key4': 'value4'},
]
expected_list_of_dicts = [{'key1': 'value1'}, {'key4': 'value4'}]
result = handler.filter_null_values(input_list_of_dicts)
assert result == expected_list_of_dicts
# Test case 5: Primitive values (non-dict, non-list)
assert handler.filter_null_values('string') == 'string'
assert handler.filter_null_values(123) == 123
assert handler.filter_null_values(True)
assert handler.filter_null_values(None) is None # None input should return None
# Test case 6: Empty containers
assert handler.filter_null_values({}) == {}
assert handler.filter_null_values([]) == []
# Test case 7: Complex nested structure
complex_input = {
'metadata': {
'name': 'test-pod',
'namespace': 'default',
'labels': {'app': 'test', 'environment': None},
'annotations': None,
},
'spec': {
'containers': [
{'name': 'container1', 'image': 'nginx', 'resources': None},
None,
{
'name': 'container2',
'image': 'redis',
'ports': [{'containerPort': 6379}, {'containerPort': None}],
},
],
'volumes': None,
},
'status': None,
}
expected_complex = {
'metadata': {'name': 'test-pod', 'namespace': 'default', 'labels': {'app': 'test'}},
'spec': {
'containers': [
{'name': 'container1', 'image': 'nginx'},
{
'name': 'container2',
'image': 'redis',
'ports': [{'containerPort': 6379}, {}],
},
]
},
}
result = handler.filter_null_values(complex_input)
assert result == expected_complex
```