awslabs.cloudwatch-mcp-server 0.0.15__py3-none-any.whl → 0.0.17__py3-none-any.whl

awslabs/cloudwatch_mcp_server/__init__.py

@@ -14,5 +14,5 @@
 
 """awslabs.cloudwatch-mcp-server"""
 
-__version__ = '0.0.15'
+__version__ = '0.0.17'
 MCP_SERVER_VERSION = __version__

awslabs/cloudwatch_mcp_server/aws_common.py

@@ -0,0 +1,55 @@
+# 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.
+
+"""AWS client utilities for CloudWatch MCP Server with multi-profile support."""
+
+from awslabs.cloudwatch_mcp_server import MCP_SERVER_VERSION
+from boto3 import Session
+from botocore.config import Config
+from os import getenv
+
+
+def get_aws_client(
+    service_name: str,
+    region_name: str | None = None,
+    profile_name: str | None = None,
+):
+    """AWS Client handler with multi-profile support.
+
+    Args:
+        service_name: AWS service name (e.g., 'logs', 'cloudwatch')
+        region_name: AWS region. Defaults to AWS_REGION env var or us-east-1 if not set
+        profile_name: AWS CLI profile name. Falls back to AWS_PROFILE env var if not specified,
+            or uses default AWS credential chain
+
+    Returns:
+        boto3 client for the specified service
+    """
+    # Set profile from parameter or environment
+    if profile_name is None:
+        profile_name = getenv('AWS_PROFILE', None)
+
+    # Configure user agent
+    config = Config(user_agent_extra=f'awslabs/mcp/cloudwatch-mcp-server/{MCP_SERVER_VERSION}')
+
+    # Create session with or without profile
+    if profile_name:
+        session = Session(profile_name=profile_name)
+    else:
+        session = Session()
+
+    # Use provided region, or session's region, or fallback to us-east-1
+    region = region_name or session.region_name or 'us-east-1'
+
+    return session.client(service_name, region_name=region, config=config)

awslabs/cloudwatch_mcp_server/cloudwatch_alarms/tools.py

@@ -14,10 +14,8 @@
 
 """CloudWatch Alarms tools for MCP server."""
 
-import boto3
 import json
-import os
-from awslabs.cloudwatch_mcp_server import MCP_SERVER_VERSION
+from awslabs.cloudwatch_mcp_server.aws_common import get_aws_client
 from awslabs.cloudwatch_mcp_server.cloudwatch_alarms.models import (
     ActiveAlarmsResponse,
     AlarmDetails,
@@ -28,7 +26,6 @@ from awslabs.cloudwatch_mcp_server.cloudwatch_alarms.models import (
     MetricAlarmSummary,
     TimeRangeSuggestion,
 )
-from botocore.config import Config
 from datetime import datetime, timedelta
 from loguru import logger
 from mcp.server.fastmcp import Context
@@ -43,21 +40,6 @@ class CloudWatchAlarmsTools:
         """Initialize the CloudWatch Alarms tools."""
         pass
 
-    def _get_cloudwatch_client(self, region: str):
-        """Create a CloudWatch client for the specified region."""
-        config = Config(user_agent_extra=f'awslabs/mcp/cloudwatch-mcp-server/{MCP_SERVER_VERSION}')
-
-        try:
-            if aws_profile := os.environ.get('AWS_PROFILE'):
-                return boto3.Session(profile_name=aws_profile, region_name=region).client(
-                    'cloudwatch', config=config
-                )
-            else:
-                return boto3.Session(region_name=region).client('cloudwatch', config=config)
-        except Exception as e:
-            logger.error(f'Error creating cloudwatch client for region {region}: {str(e)}')
-            raise
-
     def register(self, mcp):
         """Register all CloudWatch Alarms tools with the MCP server."""
         # Register get_active_alarms tool
@@ -76,9 +58,17 @@ class CloudWatchAlarmsTools:
             ),
         ] = 50,
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> ActiveAlarmsResponse:
         """Gets all CloudWatch Alarms currently in ALARM state.
 
@@ -92,7 +82,8 @@ class CloudWatchAlarmsTools:
         Args:
             ctx: The MCP context object for error handling and logging.
             max_items: Maximum number of alarms to return (default: 50).
-            region: AWS region to query. Defaults to 'us-east-1'.
+            region: AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.
+            profile_name: AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.
 
         Returns:
             ActiveAlarmsResponse: Response containing active alarms.
@@ -118,7 +109,7 @@ class CloudWatchAlarmsTools:
                 raise ValueError('max_items must be at least 1')
 
             # Create CloudWatch client for the specified region
-            cloudwatch_client = self._get_cloudwatch_client(region)
+            cloudwatch_client = get_aws_client('cloudwatch', region, profile_name)
 
             # Fetch active alarms using paginator
             logger.info(f'Fetching up to {max_items} active alarms')
@@ -220,9 +211,17 @@ class CloudWatchAlarmsTools:
             ),
         ] = False,
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> Union[AlarmHistoryResponse, CompositeAlarmComponentResponse]:
         """Gets the history for a CloudWatch alarm with time range suggestions for investigation.
 
@@ -237,13 +236,14 @@ class CloudWatchAlarmsTools:
 
         Args:
             ctx: The MCP context object for error handling and logging.
-            region: AWS region to query. Defaults to 'us-east-1'.
+            region: AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.
             alarm_name: Name of the alarm to retrieve history for.
             start_time: Optional start time for the history query. Defaults to 24 hours ago.
             end_time: Optional end time for the history query. Defaults to current time.
             history_item_type: Optional type of history items to retrieve. Defaults to 'StateUpdate'.
             max_items: Maximum number of history items to return. Defaults to 50.
             include_component_alarms: For composite alarms, whether to include details about component alarms.
+            profile_name: AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.
 
         Returns:
             Union[AlarmHistoryResponse, CompositeAlarmComponentResponse]: Either a response containing
@@ -271,7 +271,7 @@ class CloudWatchAlarmsTools:
                 history_item_type = 'StateUpdate'
 
             # Create CloudWatch client for the specified region
-            cloudwatch_client = self._get_cloudwatch_client(region)
+            cloudwatch_client = get_aws_client('cloudwatch', region, profile_name)
 
             # Set up default time range (last 24 hours)
             if end_time is None or not isinstance(end_time, str):

awslabs/cloudwatch_mcp_server/cloudwatch_logs/tools.py

@@ -15,10 +15,8 @@
 """CloudWatch Logs tools for MCP server."""
 
 import asyncio
-import boto3
 import datetime
-import os
-from awslabs.cloudwatch_mcp_server import MCP_SERVER_VERSION
+from awslabs.cloudwatch_mcp_server.aws_common import get_aws_client
 from awslabs.cloudwatch_mcp_server.cloudwatch_logs.models import (
     LogAnomaly,
     LogAnomalyDetector,
@@ -34,7 +32,6 @@ from awslabs.cloudwatch_mcp_server.common import (
     filter_by_prefixes,
     remove_null_values,
 )
-from botocore.config import Config
 from loguru import logger
 from mcp.server.fastmcp import Context
 from pydantic import Field
@@ -47,31 +44,7 @@ class CloudWatchLogsTools:
 
     def __init__(self):
         """Initialize the CloudWatch Logs tools."""
-        self._logs_client = None
-        self._logs_client_region = None
-
-    @property
-    def logs_client(self):
-        """Get the logs client for the default region (us-east-1)."""
-        if self._logs_client is None or self._logs_client_region != 'us-east-1':
-            self._logs_client = self._get_logs_client('us-east-1')
-            self._logs_client_region = 'us-east-1'
-        return self._logs_client
-
-    def _get_logs_client(self, region: str):
-        """Create a CloudWatch Logs client for the specified region."""
-        config = Config(user_agent_extra=f'awslabs/mcp/cloudwatch-mcp-server/{MCP_SERVER_VERSION}')
-
-        try:
-            if aws_profile := os.environ.get('AWS_PROFILE'):
-                return boto3.Session(profile_name=aws_profile, region_name=region).client(
-                    'logs', config=config
-                )
-            else:
-                return boto3.Session(region_name=region).client('logs', config=config)
-        except Exception as e:
-            logger.error(f'Error creating cloudwatch logs client for region {region}: {str(e)}')
-            raise
+        pass
 
     def _validate_log_group_parameters(
         self, log_group_names: Optional[List[str]], log_group_identifiers: Optional[List[str]]
@@ -267,9 +240,17 @@ class CloudWatchLogsTools:
             int | None, Field(description=('The maximum number of log groups to return.'))
         ] = None,
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> LogsMetadata:
         """Lists AWS CloudWatch log groups and saved queries associated with them, optionally filtering by a name prefix.
 
@@ -295,7 +276,7 @@ class CloudWatchLogsTools:
             Any saved queries that are applicable to the returned log groups are also included.
         """
         # Create logs client for the specified region
-        logs_client = self._get_logs_client(region)
+        logs_client = get_aws_client('logs', region, profile_name)
 
         def describe_log_groups() -> List[LogGroupMetadata]:
             paginator = logs_client.get_paginator('describe_log_groups')
@@ -379,9 +360,17 @@ class CloudWatchLogsTools:
             ),
         ),
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> LogsAnalysisResult:
         """Analyzes a CloudWatch log group for anomalies, message patterns, and error patterns within a specified time window.
 
@@ -426,7 +415,7 @@ class CloudWatchLogsTools:
             return log_group_arn in anomaly.logGroupArnList
 
         # Create logs client for the specified region
-        logs_client = self._get_logs_client(region)
+        logs_client = get_aws_client('logs', region, profile_name)
 
         async def get_applicable_anomalies() -> LogAnomalyResults:
             detectors: List[LogAnomalyDetector] = []
@@ -552,9 +541,17 @@ class CloudWatchLogsTools:
             ),
         ] = 30,
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> Dict:
         """Executes a CloudWatch Logs Insights query and waits for the results to be available.
 
@@ -590,7 +587,7 @@ class CloudWatchLogsTools:
             )
 
             # Create logs client for the specified region
-            logs_client = self._get_logs_client(region)
+            logs_client = get_aws_client('logs', region, profile_name)
 
             # Start the query
             start_response = logs_client.start_query(**remove_null_values(kwargs))
@@ -621,9 +618,17 @@ class CloudWatchLogsTools:
             description='The unique ID of the query to retrieve the results for. CRITICAL: This ID is returned by the execute_log_insights_query tool.',
         ),
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> Dict:
         """Retrieves the results of a previously started CloudWatch Logs Insights query.
 
@@ -640,7 +645,7 @@ class CloudWatchLogsTools:
         """
         try:
             # Create logs client for the specified region
-            logs_client = self._get_logs_client(region)
+            logs_client = get_aws_client('logs', region, profile_name)
 
             response = logs_client.get_query_results(queryId=query_id)
 
@@ -675,9 +680,17 @@ class CloudWatchLogsTools:
             description='The unique ID of the ongoing query to cancel. CRITICAL: This ID is returned by the execute_log_insights_query tool.',
         ),
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> LogsQueryCancelResult:
         """Cancels an ongoing CloudWatch Logs Insights query. If the query has already ended, returns an error that the given query is not running.
 
@@ -690,7 +703,7 @@ class CloudWatchLogsTools:
         """
         try:
             # Create logs client for the specified region
-            logs_client = self._get_logs_client(region)
+            logs_client = get_aws_client('logs', region, profile_name)
 
             response = logs_client.stop_query(queryId=query_id)
             return LogsQueryCancelResult.model_validate(response)

awslabs/cloudwatch_mcp_server/cloudwatch_metrics/tools.py

@@ -14,10 +14,8 @@
 
 """CloudWatch Metrics tools for MCP server."""
 
-import boto3
 import json
-import os
-from awslabs.cloudwatch_mcp_server import MCP_SERVER_VERSION
+from awslabs.cloudwatch_mcp_server.aws_common import get_aws_client
 from awslabs.cloudwatch_mcp_server.cloudwatch_metrics.cloudformation_template_generator import (
     CloudFormationTemplateGenerator,
 )
@@ -42,7 +40,6 @@ from awslabs.cloudwatch_mcp_server.cloudwatch_metrics.models import (
     MetricMetadataIndexKey,
     StaticAlarmThreshold,
 )
-from botocore.config import Config
 from datetime import datetime, timedelta, timezone
 from loguru import logger
 from mcp.server.fastmcp import Context
@@ -64,21 +61,6 @@ class CloudWatchMetricsTools:
         self.cloudformation_generator = CloudFormationTemplateGenerator()
         self.metric_analyzer = MetricAnalyzer()
 
-    def _get_cloudwatch_client(self, region: str):
-        """Create a CloudWatch client for the specified region."""
-        config = Config(user_agent_extra=f'awslabs/mcp/cloudwatch-mcp-server/{MCP_SERVER_VERSION}')
-
-        try:
-            if aws_profile := os.environ.get('AWS_PROFILE'):
-                return boto3.Session(profile_name=aws_profile, region_name=region).client(
-                    'cloudwatch', config=config
-                )
-            else:
-                return boto3.Session(region_name=region).client('cloudwatch', config=config)
-        except Exception as e:
-            logger.error(f'Error creating cloudwatch client for region {region}: {str(e)}')
-            raise
-
     def _load_and_index_metadata(self) -> Dict[MetricMetadataIndexKey, Any]:
         """Load metric metadata from JSON file and create an indexed structure.
 
@@ -225,9 +207,17 @@ class CloudWatchMetricsTools:
             ),
         ] = None,
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
     ) -> GetMetricDataResponse:
         """Retrieves CloudWatch metric data for a specific metric.
 
@@ -371,7 +361,7 @@ class CloudWatchMetricsTools:
                 )
 
             # Create CloudWatch client for the specified region
-            cloudwatch_client = self._get_cloudwatch_client(region)
+            cloudwatch_client = get_aws_client('cloudwatch', region, profile_name)
 
             # Call the GetMetricData API
             response = cloudwatch_client.get_metric_data(
@@ -610,18 +600,13 @@ class CloudWatchMetricsTools:
         metric_name: str = Field(
             ..., description="The name of the metric (e.g., 'CPUUtilization', 'Duration')"
         ),
-        region: Annotated[
-            str,
-            Field(
-                description='AWS region for consistency. Note: This function uses local metadata and does not make AWS API calls. Defaults to us-east-1.'
-            ),
-        ] = 'us-east-1',
     ) -> Optional[MetricMetadata]:
         """Gets metadata for a CloudWatch metric including description, unit and recommended
         statistics that can be used for metric data retrieval.
 
         This tool retrieves comprehensive metadata about a specific CloudWatch metric
-        identified by its namespace and metric name.
+        identified by its namespace and metric name. Note: This function uses local metadata
+        and does not make AWS API calls.
 
         Usage: Use this tool to get detailed information about CloudWatch metrics,
         including their descriptions, units, and recommended statistics to use.
@@ -630,7 +615,6 @@ class CloudWatchMetricsTools:
             ctx: The MCP context object for error handling and logging.
             namespace: The metric namespace (e.g., "AWS/EC2", "AWS/Lambda")
             metric_name: The name of the metric (e.g., "CPUUtilization", "Duration")
-            region: AWS region to query. Defaults to 'us-east-1'.
 
         Returns:
             Optional[MetricMetadata]: An object containing the metric's description,
@@ -692,11 +676,17 @@ class CloudWatchMetricsTools:
             description='List of dimensions that identify the metric, each with name and value',
         ),
         region: Annotated[
-            str,
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
             Field(
-                description='AWS region for consistency. Note: This function uses local metadata and does not make AWS API calls. Defaults to us-east-1.'
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
             ),
-        ] = 'us-east-1',
+        ] = None,
         statistic: Annotated[
             Literal[
                 'AVG',
@@ -727,7 +717,8 @@ class CloudWatchMetricsTools:
             namespace: The metric namespace (e.g., "AWS/EC2", "AWS/Lambda")
             metric_name: The name of the metric (e.g., "CPUUtilization", "Duration")
             dimensions: List of dimensions with name and value pairs
-            region: AWS region to query. Defaults to 'us-east-1'.
+            region: AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.
+            profile_name: AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.
             statistic: The statistic to use for alarm recommendations. Must match the metric's data type:
                 - Aggregate count metrics (RequestCount, Errors, Faults, Throttles, CacheHits, Connections, EventsProcessed): Use 'Sum'
                 - Event occurrence metrics (Invocations, CacheMisses): Use 'SampleCount'
@@ -1057,9 +1048,17 @@ class CloudWatchMetricsTools:
             description='List of dimensions that identify the metric, each with name and value',
         ),
         region: Annotated[
-            str,
-            Field(description='AWS region to query. Defaults to us-east-1.'),
-        ] = 'us-east-1',
+            str | None,
+            Field(
+                description='AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.'
+            ),
+        ] = None,
+        profile_name: Annotated[
+            str | None,
+            Field(
+                description='AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.'
+            ),
+        ] = None,
         statistic: Annotated[
             Literal[
                 'AVG',
@@ -1091,8 +1090,9 @@ class CloudWatchMetricsTools:
             namespace: The metric namespace (e.g., "AWS/EC2", "AWS/Lambda")
             metric_name: The name of the metric (e.g., "CPUUtilization", "Duration")
             dimensions: List of dimensions with name and value pairs
+            region: AWS region to query. Defaults to AWS_REGION environment variable or us-east-1 if not set.
+            profile_name: AWS CLI Profile Name to use for AWS access. Falls back to AWS_PROFILE environment variable if not specified, or uses default AWS credential chain.
             statistic: The statistic to use for metric analysis. For guidance on choosing the correct statistic, refer to the get_recommended_metric_alarms tool.
-            region: AWS region to query. Defaults to 'us-east-1'.
 
         Returns:
             Dict[str, Any]: Analysis results including:

{awslabs_cloudwatch_mcp_server-0.0.15.dist-info → awslabs_cloudwatch_mcp_server-0.0.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cloudwatch-mcp-server
-Version: 0.0.15
+Version: 0.0.17
 Summary: An AWS Labs Model Context Protocol (MCP) server for cloudwatch
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/cloudwatch-mcp-server/
@@ -97,12 +97,12 @@ Alarm Recommendations - Suggests recommended alarm configurations for CloudWatch
 
 #### One Click Install
 
-| Cursor | VS Code |
-|:------:|:-------:|
-| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en/install-mcp?name=awslabs.cloudwatch-mcp-server&config=ewogICAgImF1dG9BcHByb3ZlIjogW10sCiAgICAiZGlzYWJsZWQiOiBmYWxzZSwKICAgICJjb21tYW5kIjogInV2eCBhd3NsYWJzLmNsb3Vkd2F0Y2gtbWNwLXNlcnZlckBsYXRlc3QiLAogICAgImVudiI6IHsKICAgICAgIkFXU19QUk9GSUxFIjogIltUaGUgQVdTIFByb2ZpbGUgTmFtZSB0byB1c2UgZm9yIEFXUyBhY2Nlc3NdIiwKICAgICAgIkZBU1RNQ1BfTE9HX0xFVkVMIjogIkVSUk9SIgogICAgfSwKICAgICJ0cmFuc3BvcnRUeXBlIjogInN0ZGlvIgp9) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=CloudWatch%20MCP%20Server&config=%7B%22autoApprove%22%3A%5B%5D%2C%22disabled%22%3Afalse%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.cloudwatch-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22%5BThe%20AWS%20Profile%20Name%20to%20use%20for%20AWS%20access%5D%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22transportType%22%3A%22stdio%22%7D) |
+| Kiro | Cursor | VS Code |
+|:----:|:------:|:-------:|
+| [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=awslabs.cloudwatch-mcp-server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.cloudwatch-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22%5BThe%20AWS%20Profile%20Name%20to%20use%20for%20AWS%20access%5D%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%7D) | [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en/install-mcp?name=awslabs.cloudwatch-mcp-server&config=ewogICAgImF1dG9BcHByb3ZlIjogW10sCiAgICAiZGlzYWJsZWQiOiBmYWxzZSwKICAgICJjb21tYW5kIjogInV2eCBhd3NsYWJzLmNsb3Vkd2F0Y2gtbWNwLXNlcnZlckBsYXRlc3QiLAogICAgImVudiI6IHsKICAgICAgIkFXU19QUk9GSUxFIjogIltUaGUgQVdTIFByb2ZpbGUgTmFtZSB0byB1c2UgZm9yIEFXUyBhY2Nlc3NdIiwKICAgICAgIkZBU1RNQ1BfTE9HX0xFVkVMIjogIkVSUk9SIgogICAgfSwKICAgICJ0cmFuc3BvcnRUeXBlIjogInN0ZGlvIgp9) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=CloudWatch%20MCP%20Server&config=%7B%22autoApprove%22%3A%5B%5D%2C%22disabled%22%3Afalse%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.cloudwatch-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22%5BThe%20AWS%20Profile%20Name%20to%20use%20for%20AWS%20access%5D%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22transportType%22%3A%22stdio%22%7D) |
 
-#### MCP Config (Q CLI, Cline)
-* For Q CLI, update MCP Config Amazon Q Developer CLI (~/.aws/amazonq/mcp.json)
+#### MCP Config (Kiro, Cline)
+* For Kiro, update MCP Config (~/.kiro/settings/mcp.json)
 * For Cline click on "Configure MCP Servers" option from MCP tab
 ```json
 {
@@ -166,7 +166,7 @@ Build and install docker image locally on the same host of your LLM client
 #### One Click Cursor Install
 [![Install CloudWatch MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://www.cursor.com/install-mcp?name=awslabs.cloudwatch-mcp-server&config=ewogICAgICAgICJjb21tYW5kIjogImRvY2tlciIsCiAgICAgICAgImFyZ3MiOiBbCiAgICAgICAgICAicnVuIiwKICAgICAgICAgICItLXJtIiwKICAgICAgICAgICItLWludGVyYWN0aXZlIiwKICAgICAgICAgICItZSBBV1NfUFJPRklMRT1bVGhlIEFXUyBQcm9maWxlIE5hbWVdIiwKICAgICAgICAgICJhd3NsYWJzL2Nsb3Vkd2F0Y2gtbWNwLXNlcnZlcjpsYXRlc3QiCiAgICAgICAgXSwKICAgICAgICAiZW52Ijoge30sCiAgICAgICAgImRpc2FibGVkIjogZmFsc2UsCiAgICAgICAgImF1dG9BcHByb3ZlIjogW10KfQ==)
 
-#### MCP Config using Docker image(Q CLI, Cline)
+#### MCP Config using Docker image(Kiro, Cline)
 ```json
   {
     "mcpServers": {

{awslabs_cloudwatch_mcp_server-0.0.15.dist-info → awslabs_cloudwatch_mcp_server-0.0.17.dist-info}/RECORD

@@ -1,21 +1,22 @@
 awslabs/__init__.py,sha256=S-EDeDHGZzllMFhAeuJx_47fv85t2OUMOcsOisD5d_8,796
-awslabs/cloudwatch_mcp_server/__init__.py,sha256=Q4ZiN-exGyvx7bTN3X3GN62oX5bn-jLG2gFAfT63MTE,709
+awslabs/cloudwatch_mcp_server/__init__.py,sha256=oEL7uQ6i0sN4lQX8Ul7-2zj7OifSCt2lOcSUwsEnS8I,709
+awslabs/cloudwatch_mcp_server/aws_common.py,sha256=g2w6VN6873reKEykbllTcBO21UBc1MtqH9uN60_KGg4,2021
 awslabs/cloudwatch_mcp_server/common.py,sha256=dbnaQlIOh4VmJvflzoJXv4JkrK7brPa1hgnrfLapJDs,2190
 awslabs/cloudwatch_mcp_server/server.py,sha256=raMeiC0F8M7cIH6-5rZnU2_DZZkPEtpvRm-5_hd9tbs,2505
 awslabs/cloudwatch_mcp_server/cloudwatch_alarms/models.py,sha256=wgwSE4JqLa0K7-3xhxGjDvGetXi-TZkmjbWtXRvx7CA,7202
-awslabs/cloudwatch_mcp_server/cloudwatch_alarms/tools.py,sha256=ftllhM1ORWpA65FGG_oPH7h9UiGwakFCJ03lqUzrVSg,30865
+awslabs/cloudwatch_mcp_server/cloudwatch_alarms/tools.py,sha256=fhRUGm4ojQ-qbZwUt6bak8LloV3Rl1KOB2lxbnOMim8,31299
 awslabs/cloudwatch_mcp_server/cloudwatch_logs/models.py,sha256=wyfxHNN5E2K49LreqKBMAZ4Vyvc2MMkxMCfyGHsK-pQ,7982
-awslabs/cloudwatch_mcp_server/cloudwatch_logs/tools.py,sha256=b0tobrfTkyEzKkqof0wNR649PWfOIA0euGSwT4qvevM,30018
+awslabs/cloudwatch_mcp_server/cloudwatch_logs/tools.py,sha256=jFzTpK_3LzEC9surX6RCGUCTjR-v1pA6GCMoA9FJRVo,30753
 awslabs/cloudwatch_mcp_server/cloudwatch_metrics/cloudformation_template_generator.py,sha256=eHnIpd5DBrVjXpmjy1n7ZxfKZA-9JkwuxogcBUg4E4I,6944
 awslabs/cloudwatch_mcp_server/cloudwatch_metrics/constants.py,sha256=v1IETRSHtckgVqjm6WgzWEi0fqYqwMrIL3M3V9k1K5A,981
 awslabs/cloudwatch_mcp_server/cloudwatch_metrics/metric_analyzer.py,sha256=t0cmrxbIPbw7gjWQXydYWxuhKnRbH_bbyzqkm7itFag,7601
 awslabs/cloudwatch_mcp_server/cloudwatch_metrics/metric_data_decomposer.py,sha256=SzB7CyyXvSIk7Qfd-5OyHAThFPjk5N3ZDbx37kjVsSs,8361
 awslabs/cloudwatch_mcp_server/cloudwatch_metrics/models.py,sha256=38ppi8euC-PurLypCAbBxyrIgeqja-5pOImQLPukDDo,10175
-awslabs/cloudwatch_mcp_server/cloudwatch_metrics/tools.py,sha256=9ZuUpPbIwV2EROFXBK5DbMYPaWjBsJYa55aWAmsq8SQ,48334
+awslabs/cloudwatch_mcp_server/cloudwatch_metrics/tools.py,sha256=MjtF2vPh0dvnYhTVVPjsQE84fpIqwHfPYmCyi7Afh5U,48763
 awslabs/cloudwatch_mcp_server/cloudwatch_metrics/data/metric_metadata.json,sha256=FlSUlfYVo1VdANrsBg50atggMNGSqZvhhZU7ca-v48c,745055
-awslabs_cloudwatch_mcp_server-0.0.15.dist-info/METADATA,sha256=DAxrmfmIEBCIOv5dNS4PmfMG8YcyKP-XSUCyL-0ljeA,10393
-awslabs_cloudwatch_mcp_server-0.0.15.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-awslabs_cloudwatch_mcp_server-0.0.15.dist-info/entry_points.txt,sha256=u8YZn3_qq9Ai7nRux17K6K7RDssOBhTSyUNyZKrQUIk,92
-awslabs_cloudwatch_mcp_server-0.0.15.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
-awslabs_cloudwatch_mcp_server-0.0.15.dist-info/licenses/NOTICE,sha256=xpvRUSHqG7LIpUZ1W_0D4sfPJG8lj51X6Mxjq1KJ6eQ,97
-awslabs_cloudwatch_mcp_server-0.0.15.dist-info/RECORD,,
+awslabs_cloudwatch_mcp_server-0.0.17.dist-info/METADATA,sha256=rrYQJ5tQsHbIGtQn1dVQ6cGetVxlpq_PlogmAGOL7SE,10767
+awslabs_cloudwatch_mcp_server-0.0.17.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+awslabs_cloudwatch_mcp_server-0.0.17.dist-info/entry_points.txt,sha256=u8YZn3_qq9Ai7nRux17K6K7RDssOBhTSyUNyZKrQUIk,92
+awslabs_cloudwatch_mcp_server-0.0.17.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_cloudwatch_mcp_server-0.0.17.dist-info/licenses/NOTICE,sha256=xpvRUSHqG7LIpUZ1W_0D4sfPJG8lj51X6Mxjq1KJ6eQ,97
+awslabs_cloudwatch_mcp_server-0.0.17.dist-info/RECORD,,