awslabs.cloudwatch-appsignals-mcp-server 0.1.11__tar.gz → 0.1.13__tar.gz

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cloudwatch-appsignals-mcp-server
-Version: 0.1.11
+Version: 0.1.13
 Summary: An AWS Labs Model Context Protocol (MCP) server for AWS Application Signals
 Project-URL: Homepage, https://awslabs.github.io/mcp/
 Project-URL: Documentation, https://awslabs.github.io/mcp/servers/cloudwatch-appsignals-mcp-server/
@@ -28,6 +28,10 @@ Requires-Dist: mcp[cli]>=1.11.0
 Requires-Dist: pydantic>=2.11.1
 Description-Content-Type: text/markdown
 
+# Deprecation Notice
+
+**IMPORTANT**: This server is deprecated, please use the cloudwatch-applicationsignals-mcp-server instead.
+
 # CloudWatch Application Signals MCP Server
 
 An MCP (Model Context Protocol) server that provides comprehensive tools for monitoring and analyzing AWS services using [AWS Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals.html).
@@ -658,14 +662,24 @@ The server requires the following AWS IAM permissions:
         "application-signals:ListServiceLevelObjectives",
         "application-signals:GetServiceLevelObjective",
         "application-signals:BatchGetServiceLevelObjectiveBudgetReport",
+        "application-signals:ListAuditFindings",
         "cloudwatch:GetMetricData",
         "cloudwatch:GetMetricStatistics",
         "logs:GetQueryResults",
         "logs:StartQuery",
         "logs:StopQuery",
+        "logs:FilterLogEvents",
         "xray:GetTraceSummaries",
         "xray:BatchGetTraces",
-        "xray:GetTraceSegmentDestination"
+        "xray:GetTraceSegmentDestination",
+        "synthetics:GetCanary",
+        "synthetics:GetCanaryRuns",
+        "s3:GetObject",
+        "s3:ListBucket",
+        "iam:GetRole",
+        "iam:ListAttachedRolePolicies",
+        "iam:GetPolicy",
+        "iam:GetPolicyVersion"
       ],
       "Resource": "*"
     }

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/README.md

@@ -1,3 +1,7 @@
+# Deprecation Notice
+
+**IMPORTANT**: This server is deprecated, please use the cloudwatch-applicationsignals-mcp-server instead.
+
 # CloudWatch Application Signals MCP Server
 
 An MCP (Model Context Protocol) server that provides comprehensive tools for monitoring and analyzing AWS services using [AWS Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals.html).
@@ -628,14 +632,24 @@ The server requires the following AWS IAM permissions:
         "application-signals:ListServiceLevelObjectives",
         "application-signals:GetServiceLevelObjective",
         "application-signals:BatchGetServiceLevelObjectiveBudgetReport",
+        "application-signals:ListAuditFindings",
         "cloudwatch:GetMetricData",
         "cloudwatch:GetMetricStatistics",
         "logs:GetQueryResults",
         "logs:StartQuery",
         "logs:StopQuery",
+        "logs:FilterLogEvents",
         "xray:GetTraceSummaries",
         "xray:BatchGetTraces",
-        "xray:GetTraceSegmentDestination"
+        "xray:GetTraceSegmentDestination",
+        "synthetics:GetCanary",
+        "synthetics:GetCanaryRuns",
+        "s3:GetObject",
+        "s3:ListBucket",
+        "iam:GetRole",
+        "iam:ListAttachedRolePolicies",
+        "iam:GetPolicy",
+        "iam:GetPolicyVersion"
       ],
       "Resource": "*"
     }

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/awslabs/cloudwatch_appsignals_mcp_server/__init__.py

@@ -14,4 +14,4 @@
 
 """AWS Application Signals MCP Server."""
 
-__version__ = '0.1.11'
+__version__ = '0.1.13'

awslabs_cloudwatch_appsignals_mcp_server-0.1.13/awslabs/cloudwatch_appsignals_mcp_server/enablement_guides/templates/ec2/ec2-python-enablement.md

@@ -0,0 +1 @@
+Placeholder content just to verify the tool can fetch the file.

awslabs_cloudwatch_appsignals_mcp_server-0.1.13/awslabs/cloudwatch_appsignals_mcp_server/enablement_tools.py

@@ -0,0 +1,147 @@
+# 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.
+
+"""CloudWatch Application Signals MCP Server - Enablement Tools."""
+
+from loguru import logger
+from pathlib import Path
+
+
+async def get_enablement_guide(
+    service_platform: str,
+    service_language: str,
+    iac_directory: str,
+    app_directory: str,
+) -> str:
+    """Get enablement guide for AWS Application Signals.
+
+    Use this tool when the user wants to:
+    - Enable Application Signals for their AWS service
+    - Set up automatic instrumentation for their application on AWS
+    - Instrument their service running on EC2, ECS, Lambda, or EKS
+
+    This tool returns step-by-step enablement instructions that guide you through
+    modifying your infrastructure and application code to enable Application Signals,
+    which is the preferred way to enable automatic instrumentation for services on AWS.
+
+    Before calling this tool:
+    1. Ensure you know where the application code is located and that you have read/write permissions
+    2. Ensure you know where the IaC code is located and that you have read/write permissions
+    3. If the user provides relative paths or descriptions (e.g., "./infrastructure", "in the root"):
+       - Use the Bash tool to run 'pwd' to get the current working directory
+       - Use file exploration tools to locate the directories
+       - Convert relative paths to absolute paths before calling this tool
+    4. This tool REQUIRES absolute paths for both iac_directory and app_directory parameters
+
+    After calling this tool, you should:
+    1. Review the enablement guide and create a visible, trackable checklist of required changes
+       - Use your system's task tracking mechanism (todo lists, markdown checklists, etc.)
+       - Each item should be granular enough to complete in one step
+       - Mark items as complete as you finish them to track progress
+       - This allows you to resume work if the context window fills up
+    2. Work through the checklist systematically, one item at a time:
+       - Identify the specific file(s) that need modification for this step
+       - Read only the relevant file(s) (DO NOT load all IaC and app files at once)
+       - Apply the changes as specified in the guide
+    3. Keep context focused: Only load files needed for the current checklist item
+
+    Important guidelines:
+    - Use ABSOLUTE PATHS when reading and writing files
+    - Do NOT modify actual application logic files (.py, .js, .java source code), only
+      modify IaC code, Dockerfiles, and dependency files (requirements.txt, pyproject.toml,
+      package.json, pom.xml, build.gradle, *.csproj, etc.) as instructed by the guide.
+    - Read application files if needed to understand the setup, but avoid modifying them
+
+    Args:
+        service_platform: The AWS platform where the service runs.
+            MUST be one of: 'ec2', 'ecs', 'lambda', 'eks' (lowercase, exact match).
+            To help user determine: check their IaC for ECS services, Lambda functions, EKS deployments, or EC2 instances.
+        service_language: The service's programming language.
+            MUST be one of: 'python', 'nodejs', 'java', 'dotnet' (lowercase, exact match).
+            IMPORTANT: Use 'nodejs' (not 'js', 'node', or 'javascript'), 'dotnet' (not 'csharp' or 'c#').
+            To help user determine: check for package.json (nodejs), requirements.txt (python), pom.xml (java), or .csproj (dotnet).
+        iac_directory: ABSOLUTE path to the Infrastructure as Code (IaC) directory (e.g., /home/user/project/infrastructure)
+        app_directory: ABSOLUTE path to the application code directory (e.g., /home/user/project/app)
+
+    Returns:
+        Markdown-formatted enablement guide with step-by-step instructions
+    """
+    logger.debug(
+        f'get_enablement_guide called: service_platform={service_platform}, service_language={service_language}, '
+        f'iac_directory={iac_directory}, app_directory={app_directory}'
+    )
+
+    # Normalize to lowercase
+    platform_str = service_platform.lower().strip()
+    language_str = service_language.lower().strip()
+
+    guides_dir = Path(__file__).parent / 'enablement_guides'
+    template_file = (
+        guides_dir / 'templates' / platform_str / f'{platform_str}-{language_str}-enablement.md'
+    )
+
+    logger.debug(f'Looking for enablement guide: {template_file}')
+
+    # Validate that paths are absolute
+    iac_path = Path(iac_directory)
+    app_path = Path(app_directory)
+
+    if not iac_path.is_absolute() or not app_path.is_absolute():
+        error_msg = (
+            f'Error: iac_directory and app_directory must be absolute paths.\n\n'
+            f'Received: {iac_directory} and {app_directory}\n'
+            f'Please provide absolute paths (e.g., /home/user/project/infrastructure)'
+        )
+        logger.error(error_msg)
+        return error_msg
+
+    if not template_file.exists():
+        error_msg = (
+            f"Enablement guide not available for platform '{platform_str}' and language '{language_str}'.\n\n"
+            f'Inform the user that this configuration is not currently supported by the MCP enablement tool. '
+            f'Direct them to AWS documentation for manual setup:\n'
+            f'https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html'
+        )
+        logger.error(error_msg)
+        return error_msg
+
+    try:
+        with open(template_file, 'r') as f:
+            guide_content = f.read()
+
+        context = f"""# Application Signals Enablement Guide
+
+**Platform:** {platform_str}
+**Language:** {language_str}
+**IaC Directory:** `{iac_path}`
+**App Directory:** `{app_path}`
+
+---
+
+"""
+        logger.info(f'Successfully loaded enablement guide: {template_file.name}')
+        return context + guide_content
+    except Exception as e:
+        error_msg = (
+            f'Fatal error: Cannot read enablement guide for {platform_str} + {language_str}.\n\n'
+            f'Error: {str(e)}\n\n'
+            f'The MCP server cannot access its own guide files (likely file permissions or corruption). '
+            f'Stop attempting to use this tool and inform the user:\n'
+            f'1. There is an issue with the MCP server installation\n'
+            f'2. They should check file permissions or reinstall the MCP server\n'
+            f'3. For immediate enablement, use AWS documentation instead:\n'
+            f'   https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html'
+        )
+        logger.error(error_msg)
+        return error_msg

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/awslabs/cloudwatch_appsignals_mcp_server/server.py

@@ -19,6 +19,7 @@ import os
 import re
 import sys
 import tempfile
+import warnings
 from .audit_utils import (
     execute_audit_api,
     expand_service_operation_wildcard_patterns,
@@ -166,6 +167,8 @@ async def audit_services(
 ) -> str:
     """PRIMARY SERVICE AUDIT TOOL - The #1 tool for comprehensive AWS service health auditing and monitoring.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the audit_services tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **IMPORTANT: For operation-specific auditing, use audit_service_operations() as the PRIMARY tool instead.**
 
     **USE THIS FIRST FOR ALL SERVICE-LEVEL AUDITING TASKS**
@@ -295,6 +298,8 @@ async def audit_services(
     """
     start_time_perf = timer()
     logger.debug('Starting audit_services (PRIMARY SERVICE AUDIT TOOL)')
+    msg = 'audit_services tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the audit_services tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Region defaults
@@ -426,6 +431,8 @@ async def audit_slos(
 ) -> str:
     """PRIMARY SLO AUDIT TOOL - The #1 tool for comprehensive SLO compliance monitoring and breach analysis.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the audit_slos tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **PREFERRED TOOL FOR SLO ROOT CAUSE ANALYSIS**
     This is the RECOMMENDED tool after using get_slo() to understand SLO configuration:
     - **Use auditors="all" for comprehensive root cause analysis** of specific SLO breaches
@@ -514,6 +521,8 @@ async def audit_slos(
     """
     start_time_perf = timer()
     logger.debug('Starting audit_slos (PRIMARY SLO AUDIT TOOL)')
+    msg = 'audit_slos tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the audit_slos tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Region defaults
@@ -639,6 +648,8 @@ async def audit_service_operations(
 ) -> str:
     """🥇 PRIMARY OPERATION AUDIT TOOL - The #1 RECOMMENDED tool for operation-specific analysis and performance investigation.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the audit_service_operations tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **⭐ USE THIS AS THE PRIMARY TOOL FOR ALL OPERATION-SPECIFIC AUDITING TASKS ⭐**
 
     **PREFERRED OVER audit_services() for operation auditing because:**
@@ -736,6 +747,8 @@ async def audit_service_operations(
     """
     start_time_perf = timer()
     logger.debug('Starting audit_service_operations (SPECIALIZED OPERATION AUDIT TOOL)')
+    msg = 'audit_service_operations tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the audit_service_operations tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Region defaults
@@ -822,6 +835,8 @@ async def audit_service_operations(
 async def analyze_canary_failures(canary_name: str, region: str = AWS_REGION) -> str:
     """Comprehensive canary failure analysis with deep dive into issues.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the analyze_canary_failures tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     Use this tool to:
     - Deep dive into canary failures with root cause identification
     - Analyze historical patterns and specific incident details
@@ -864,6 +879,9 @@ async def analyze_canary_failures(canary_name: str, region: str = AWS_REGION) ->
             - Root cause identification with specific remediation steps
             - Historical pattern analysis and trend insights
     """
+    msg = 'analyze_canary_failures tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the analyze_canary_failures tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
+
     try:
         # Get recent canary runs
         response = synthetics_client.get_canary_runs(Name=canary_name, MaxResults=5)

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/awslabs/cloudwatch_appsignals_mcp_server/service_tools.py

@@ -14,6 +14,7 @@
 
 """CloudWatch Application Signals MCP Server - Service-related tools."""
 
+import warnings
 from .aws_clients import appsignals_client, cloudwatch_client
 from botocore.exceptions import ClientError
 from datetime import datetime, timedelta, timezone
@@ -25,6 +26,8 @@ from time import perf_counter as timer
 async def list_monitored_services() -> str:
     """OPTIONAL TOOL for service discovery - audit_services() can automatically discover services using wildcard patterns.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the list_monitored_services tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **IMPORTANT: For service auditing and operation analysis, use audit_services() as the PRIMARY tool instead.**
 
     **WHEN TO USE THIS TOOL:**
@@ -71,6 +74,8 @@ async def list_monitored_services() -> str:
     """
     start_time_perf = timer()
     logger.debug('Starting list_application_signals_services request')
+    msg = 'list_monitored_services tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the list_monitored_services tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Calculate time range (last 24 hours)
@@ -129,6 +134,8 @@ async def get_service_detail(
 ) -> str:
     """Get detailed information about a specific Application Signals service.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the get_service_detail tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **IMPORTANT: For operation auditing, use audit_services() as the PRIMARY tool instead.**
 
     **RECOMMENDED WORKFLOW FOR OPERATION AUDITING:**
@@ -161,6 +168,8 @@ async def get_service_detail(
     """
     start_time_perf = timer()
     logger.debug(f'Starting get_service_healthy_detail request for service: {service_name}')
+    msg = 'get_service_detail tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the get_service_detail tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Calculate time range (last 24 hours)
@@ -273,6 +282,8 @@ async def query_service_metrics(
 ) -> str:
     """Get CloudWatch metrics for a specific Application Signals service.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the query_service_metrics tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     Use this tool to:
     - Analyze service performance (latency, throughput)
     - Check error rates and reliability
@@ -298,6 +309,8 @@ async def query_service_metrics(
     logger.info(
         f'Starting query_service_metrics request - service: {service_name}, metric: {metric_name}, hours: {hours}'
     )
+    msg = 'query_service_metrics tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the query_service_metrics tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Calculate time range
@@ -469,6 +482,8 @@ async def list_service_operations(
 ) -> str:
     """OPERATION DISCOVERY TOOL - For operation inventory only. Use audit_services() as PRIMARY tool for operation auditing.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the list_service_operations tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **IMPORTANT: For operation auditing and performance analysis, use audit_services() as the PRIMARY tool instead.**
 
     **CRITICAL LIMITATION: This tool only discovers operations that have been ACTIVELY INVOKED in the specified time window.**
@@ -517,6 +532,8 @@ async def list_service_operations(
     """
     start_time_perf = timer()
     logger.debug(f'Starting list_service_operations request for service: {service_name}')
+    msg = 'list_service_operations tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the list_service_operations tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Calculate time range - enforce 24 hour maximum for Application Signals operation discovery

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/awslabs/cloudwatch_appsignals_mcp_server/slo_tools.py

@@ -15,6 +15,7 @@
 """CloudWatch Application Signals MCP Server - SLO-related tools."""
 
 import json
+import warnings
 from .aws_clients import appsignals_client
 from botocore.exceptions import ClientError
 from loguru import logger
@@ -27,6 +28,8 @@ async def get_slo(
 ) -> str:
     """Get detailed information about a specific Service Level Objective (SLO).
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the get_slo tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **RECOMMENDED WORKFLOW AFTER USING THIS TOOL:**
     After getting SLO configuration details, use `audit_slos()` with `auditors="all"` for comprehensive root cause analysis:
     - `audit_slos(slo_targets='[{"Type":"slo","Data":{"Slo":{"SloName":"your-slo-name"}}}]', auditors="all")`
@@ -60,6 +63,8 @@ async def get_slo(
     """
     start_time_perf = timer()
     logger.info(f'Starting get_service_level_objective request for SLO: {slo_id}')
+    msg = 'get_slo tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the get_slo tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         response = appsignals_client.get_service_level_objective(Id=slo_id)
@@ -289,6 +294,8 @@ async def list_slos(
 ) -> str:
     """List all Service Level Objectives (SLOs) in Application Signals.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the list_slos tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     Use this tool to:
     - Get a complete list of all SLOs in your account
     - Discover SLO names and ARNs for use with other tools
@@ -309,6 +316,8 @@ async def list_slos(
     """
     start_time_perf = timer()
     logger.debug('Starting list_slos request')
+    msg = 'list_slos tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the list_slos tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Parse key_attributes JSON string

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py

@@ -16,6 +16,7 @@
 
 import asyncio
 import json
+import warnings
 from .aws_clients import appsignals_client, logs_client, xray_client
 from .sli_report_client import AWSConfig, SLIReportClient
 from .utils import remove_null_values
@@ -134,6 +135,8 @@ async def search_transaction_spans(
 ) -> Dict:
     """Executes a CloudWatch Logs Insights query for transaction search (100% sampled trace data).
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the search_transaction_spans tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     IMPORTANT: If log_group_name is not provided use 'aws/spans' as default cloudwatch log group name.
     The volume of returned logs can easily overwhelm the agent context window. Always include a limit in the query
     (| limit 50) or using the limit parameter.
@@ -163,6 +166,8 @@ async def search_transaction_spans(
         f'Starting search_transactions - log_group: {log_group_name}, start: {start_time}, end: {end_time}'
     )
     logger.debug(f'Query string: {query_string}')
+    msg = 'search_transaction_spans tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the search_transaction_spans tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     # Check if transaction search is enabled
     is_enabled, destination, status = check_transaction_search_enabled()
@@ -277,6 +282,8 @@ async def query_sampled_traces(
 ) -> str:
     """SECONDARY TRACE TOOL - Query AWS X-Ray traces (5% sampled data) for trace investigation.
 
+    **IMPORTANT**: This tool and server is being deprecated. If available, please use the query_sampled_traces tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     ⚠️ **IMPORTANT: Consider using audit_slos() with auditors="all" instead for comprehensive root cause analysis**
 
     **RECOMMENDED WORKFLOW FOR OPERATION DISCOVERY:**
@@ -349,6 +356,8 @@ async def query_sampled_traces(
         JSON string containing trace summaries with error status, duration, and service details
     """
     start_time_perf = timer()
+    msg = 'query_sampled_traces tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the query_sampled_traces tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     # Use AWS_REGION environment variable if region not provided
     if not region:
@@ -544,6 +553,8 @@ async def list_slis(
 ) -> str:
     """SPECIALIZED TOOL - Use audit_service_health() as the PRIMARY tool for service auditing.
 
+     **IMPORTANT**: This tool and server is being deprecated. If available, please use the list_slis tool in the cloudwatch-applicationsignals-mcp-server instead.
+
     **IMPORTANT: audit_service_health() is the PRIMARY and PREFERRED tool for all service auditing tasks.**
 
     Only use this tool when audit_service_health() cannot handle your specific requirements, such as:
@@ -570,6 +581,8 @@ async def list_slis(
     """
     start_time_perf = timer()
     logger.info(f'Starting get_sli_status request for last {hours} hours')
+    msg = 'list_slis tool in cloudwatch-appsignals-mcp-server is deprecated. Please use the list_slis tool in cloudwatch-applicationsignals-mcp-server instead.'
+    warnings.warn(msg, DeprecationWarning, stacklevel=1)
 
     try:
         # Calculate time range

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awslabs.cloudwatch-appsignals-mcp-server"
-version = "0.1.11"
+version = "0.1.13"
 description = "An AWS Labs Model Context Protocol (MCP) server for AWS Application Signals"
 readme = "README.md"
 requires-python = ">=3.10"

awslabs_cloudwatch_appsignals_mcp_server-0.1.13/tests/test_enablement_tools.py

@@ -0,0 +1,218 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+"""Tests for enablement_tools module."""
+
+import pytest
+from awslabs.cloudwatch_appsignals_mcp_server.enablement_tools import get_enablement_guide
+from unittest.mock import patch
+
+
+# Absolute paths for testing (no need to create real directories)
+ABSOLUTE_PATHS = {'iac': '/tmp/test/infrastructure/cdk', 'app': '/tmp/test/app/src'}
+
+
+class TestGetEnablementGuide:
+    """Test get_enablement_guide function."""
+
+    @pytest.mark.asyncio
+    async def test_successful_guide_fetch(self, tmp_path, monkeypatch):
+        """Test successful guide fetching when template exists."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='python',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        assert '# Application Signals Enablement Guide' in result
+        assert 'Placeholder content just to verify the tool can fetch the file.' in result
+        assert ABSOLUTE_PATHS['iac'] in result
+        assert ABSOLUTE_PATHS['app'] in result
+
+    @pytest.mark.asyncio
+    async def test_all_valid_platforms(self):
+        """Test that all valid platforms are accepted."""
+        valid_platforms = ['ec2', 'ecs', 'lambda', 'eks']
+
+        for platform in valid_platforms:
+            result = await get_enablement_guide(
+                service_platform=platform,
+                service_language='python',
+                iac_directory=ABSOLUTE_PATHS['iac'],
+                app_directory=ABSOLUTE_PATHS['app'],
+            )
+
+            # Should either succeed or say template not found with friendly message
+            assert (
+                'Enablement guide not available' in result
+                or '# Application Signals Enablement Guide' in result
+            )
+
+    @pytest.mark.asyncio
+    async def test_all_valid_languages(self):
+        """Test that all valid languages are accepted."""
+        valid_languages = ['python', 'nodejs', 'java', 'dotnet']
+
+        for language in valid_languages:
+            result = await get_enablement_guide(
+                service_platform='ec2',
+                service_language=language,
+                iac_directory=ABSOLUTE_PATHS['iac'],
+                app_directory=ABSOLUTE_PATHS['app'],
+            )
+
+            # Should either succeed or say template not found with friendly message
+            assert (
+                'Enablement guide not available' in result
+                or '# Application Signals Enablement Guide' in result
+            )
+
+    @pytest.mark.asyncio
+    async def test_relative_path_rejected(self):
+        """Test that relative paths are rejected with clear error message."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='python',
+            iac_directory='infrastructure/cdk',
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        assert 'Error: iac_directory and app_directory must be absolute paths' in result
+        assert 'infrastructure/cdk' in result
+
+    @pytest.mark.asyncio
+    async def test_relative_app_directory_rejected(self):
+        """Test that relative app directory is rejected with clear error message."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='python',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory='app/src',
+        )
+
+        assert 'Error: iac_directory and app_directory must be absolute paths' in result
+        assert 'app/src' in result
+
+    @pytest.mark.asyncio
+    async def test_absolute_path_handling(self):
+        """Test that absolute paths are handled correctly."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='python',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        assert '# Application Signals Enablement Guide' in result
+        assert ABSOLUTE_PATHS['iac'] in result
+        assert ABSOLUTE_PATHS['app'] in result
+
+    @pytest.mark.asyncio
+    async def test_unsupported_language_ruby(self):
+        """Test that unsupported language (ruby) returns friendly error message."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='ruby',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        assert 'Enablement guide not available' in result
+        assert 'ruby' in result.lower()
+        assert 'not currently supported' in result
+
+    @pytest.mark.asyncio
+    async def test_unsupported_platform_k8s(self):
+        """Test that unsupported platform (k8s) returns friendly error message."""
+        result = await get_enablement_guide(
+            service_platform='k8s',
+            service_language='python',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        assert 'Enablement guide not available' in result
+        assert 'k8s' in result.lower()
+        assert 'not currently supported' in result
+
+    @pytest.mark.asyncio
+    async def test_case_insensitive_platform(self):
+        """Test that uppercase platform names are normalized to lowercase."""
+        result = await get_enablement_guide(
+            service_platform='EC2',
+            service_language='python',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        # Should work the same as lowercase
+        assert 'Error: iac_directory and app_directory must be absolute paths' not in result
+        assert (
+            '# Application Signals Enablement Guide' in result
+            or 'Enablement guide not available' in result
+        )
+
+    @pytest.mark.asyncio
+    async def test_case_insensitive_language(self):
+        """Test that uppercase language names are normalized to lowercase."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='PYTHON',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        # Should work the same as lowercase
+        assert 'Error: iac_directory and app_directory must be absolute paths' not in result
+        assert (
+            '# Application Signals Enablement Guide' in result
+            or 'Enablement guide not available' in result
+        )
+
+    @pytest.mark.asyncio
+    async def test_whitespace_trimming(self):
+        """Test that leading/trailing whitespace is trimmed from inputs."""
+        result = await get_enablement_guide(
+            service_platform='  ec2  ',
+            service_language='  python  ',
+            iac_directory=ABSOLUTE_PATHS['iac'],
+            app_directory=ABSOLUTE_PATHS['app'],
+        )
+
+        # Should work the same as trimmed input
+        assert 'Error: iac_directory and app_directory must be absolute paths' not in result
+        assert (
+            '# Application Signals Enablement Guide' in result
+            or 'Enablement guide not available' in result
+        )
+
+    @pytest.mark.asyncio
+    async def test_both_paths_relative(self):
+        """Test that error message shows both paths when both are relative."""
+        result = await get_enablement_guide(
+            service_platform='ec2',
+            service_language='python',
+            iac_directory='infrastructure/cdk',
+            app_directory='app/src',
+        )
+
+        assert 'Error: iac_directory and app_directory must be absolute paths' in result
+        assert 'infrastructure/cdk' in result
+        assert 'app/src' in result
+
+    @pytest.mark.asyncio
+    async def test_file_read_error(self):
+        """Test that file read errors are handled gracefully with helpful message."""
+        with patch('builtins.open', side_effect=PermissionError('Permission denied')):
+            result = await get_enablement_guide(
+                service_platform='ec2',
+                service_language='python',
+                iac_directory=ABSOLUTE_PATHS['iac'],
+                app_directory=ABSOLUTE_PATHS['app'],
+            )
+
+        assert 'Fatal error: Cannot read enablement guide' in result
+        assert 'Permission denied' in result
+        assert 'file permissions or reinstall' in result
+        assert 'issue with the MCP server installation' in result

awslabs_cloudwatch_appsignals_mcp_server-0.1.13/uv-requirements.txt

@@ -0,0 +1,27 @@
+#
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
+#
+#    pip-compile --generate-hashes --output-file=uv-requirements.txt --strip-extras uv-requirements.in
+#
+uv==0.9.6 \
+    --hash=sha256:0169a85d3ba5ef1c37089d64ff26de573439ca84ecf549276a2eee42d7f833f2 \
+    --hash=sha256:0fde18c22376c8b02954c7db3847bc75ac42619932c44b43f49d056e5cfb05f9 \
+    --hash=sha256:166175ba952d2ad727e1dbd57d7cfc1782dfe7b8d79972174a46a7aa33ddceec \
+    --hash=sha256:3c2c2b2b093330e603d838fec26941ab6f62e8d62a012f9fa0d5ed88da39d907 \
+    --hash=sha256:538716ec97f8d899baa7e1c427f4411525459c0ef72ea9b3625ce9610c9976e6 \
+    --hash=sha256:547fd27ab5da7cd1a833288a36858852451d416a056825f162ecf2af5be6f8b8 \
+    --hash=sha256:62e3f057a9ae5e5003a7cd56b617e940f519f6dabcbb22d36cdd0149df25d409 \
+    --hash=sha256:6403176b55388cf94fb8737e73b26ee2a7b1805a9139da5afa951210986d4fcd \
+    --hash=sha256:7e89c964f614fa3f0481060cac709d6da50feac553e1e11227d6c4c81c87af7c \
+    --hash=sha256:86e05782f9b75d39ab1c0af98bf11e87e646a36a61d425021d5b284073e56315 \
+    --hash=sha256:90122a76e6441b8c580fc9faf06bd8c4dbe276cb1c185ad91eceb2afa78e492a \
+    --hash=sha256:95a62c1f668272555ad0c446bf44a9924dee06054b831d04c162e0bad736dc28 \
+    --hash=sha256:a7c6067919d87208c4a6092033c3bc9799cb8be1c8bc6ef419a1f6d42a755329 \
+    --hash=sha256:b2f934737c93f88c906b6a47bcc083170210fe5d66565e80a7c139599e5cbf2f \
+    --hash=sha256:b31377ebf2d0499afc5abe3fe1abded5ca843f3a1161b432fe26eb0ce15bab8e \
+    --hash=sha256:d1072db92cc9525febdf9d113c23916dfc20ca03e21218cc7beefe7185a90631 \
+    --hash=sha256:e700b2098f9d365061c572d0729b4e8bc71c6468d83dfaae2537cd66e3cb1b98 \
+    --hash=sha256:ea67369918af24ea7e01991dfc8b8988d1b0b7c49cb39d9e5bc0c409930a0a3f \
+    --hash=sha256:f0ba311b3ca49d246f36d444d3ee81571619ef95e5f509eb694a81defcbed262
+    # via -r uv-requirements.in (contents of `uv==0.9.6`)

{awslabs_cloudwatch_appsignals_mcp_server-0.1.11 → awslabs_cloudwatch_appsignals_mcp_server-0.1.13}/uv.lock

@@ -46,7 +46,7 @@ wheels = [
 
 [[package]]
 name = "awslabs-cloudwatch-appsignals-mcp-server"
-version = "0.1.11"
+version = "0.1.13"
 source = { editable = "." }
 dependencies = [
     { name = "boto3" },

awslabs_cloudwatch_appsignals_mcp_server-0.1.11/uv-requirements.txt

@@ -1,24 +0,0 @@
-# This file was autogenerated by uv via the following command:
-#    echo "uv==0.8.10" > uv-requirements.in
-#    uv pip compile --generate-hashes --output-file=uv-requirements.txt --strip-extras --python=3.10 uv-requirements.in
-uv==0.8.10 \
-    --hash=sha256:31e4fc37ee94b94c032384a0957ad32ba7dce4ce6c04b4880fd3e31e25e51a82 \
-    --hash=sha256:36a5ce708d52388c37043e7335f9eb3fea5a19a56166a2cc6adb365179a1cd77 \
-    --hash=sha256:38286d230daad82388469c8dc7a1d2f5dc279c11178319c886d1a88d7938e513 \
-    --hash=sha256:3e190cee3bb2b4f574a419eef87ae8e33f713e9cd6f856b83277ece70ad9ca9b \
-    --hash=sha256:3fdf89fc40af9902141c39ed943bcfca15664623363335eb032a44f22001e2b4 \
-    --hash=sha256:4cc190d403a89e46d13cec83b6f8e8d7d07aaf1e5a996eac9a3f0c2a8cd92537 \
-    --hash=sha256:57b71dc79eff25a5419d3fe4a563d3b9397f55d789f685ef27f43f033b31f482 \
-    --hash=sha256:86fe044c2be43977566a0d184a487edd7aace2febb757fd95927684b629ef50b \
-    --hash=sha256:88df34c32555064fae459cce665757619fd1af7deb2dc393352b15d909d2d131 \
-    --hash=sha256:9ad21eeaa4156a1bf5ed85903f80db06e2c02badd3a587ba98d3171517960555 \
-    --hash=sha256:a5495b5a6e3111c03cf5e4dbdd598bc8fd1da887e3920d58cd5a2d4c8bc9a473 \
-    --hash=sha256:ab072cd3bf2f9dc264659a1ff48ad91a910ac4830bcfe965e2d3f89c86646f46 \
-    --hash=sha256:af8a5526b0e331775a264fa0dbccfd53c183cb974f269a208af136d7561f9eb2 \
-    --hash=sha256:b00637c63d5dfc9f879281c5c91db2bb909ab1f9ab275dab015e7fb6cac6be5b \
-    --hash=sha256:b3ff3c451fcd23ea78356d8c18e802d0e423cbe655273601e3ec039a51b33286 \
-    --hash=sha256:c4a493cd4b15b3aef11523531aff96a77a586666a63e842fa437966b7b7ee62d \
-    --hash=sha256:defc50bb319be2d58be74a680710cd4b7697e88d5f79974eacd354df95f0b6b0 \
-    --hash=sha256:e0a02bcec766eb0862b7082ab746b204add7d9fcaa62322502d159b5a7ccc54a \
-    --hash=sha256:eb79a46d8099f563ef58237bf4e9009f876a40145e757ea883a92b24b724d01e
-    # via -r uv-requirements.in