awslabs.eks-mcp-server 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

awslabs/eks_mcp_server/scripts/update_eks_cloudwatch_metrics_guidance.py

@@ -0,0 +1,280 @@
+#!/usr/bin/env python3
+# 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.
+
+"""Script to scrape CloudWatch metrics data from AWS documentation and update the metrics guidance JSON file.
+
+This script fetches the EKS and Kubernetes Container Insights metrics table from the AWS documentation,
+extracts the metric names, dimensions, and descriptions, and updates the eks_cloudwatch_metrics_guidance.json file.
+"""
+
+import json
+import logging
+import os
+import re
+import requests
+from bs4 import BeautifulSoup, Tag
+from typing import Any, Dict, List
+
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+logger = logging.getLogger(__name__)
+
+# URL of the AWS documentation page containing the metrics table
+DOCS_URL = 'https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-EKS.html'
+
+# Path to the metrics guidance JSON file (relative to the script location)
+METRICS_FILE_PATH = os.path.join(
+    os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
+    'data',
+    'eks_cloudwatch_metrics_guidance.json',
+)
+
+
+def fetch_documentation_page() -> str:
+    """Fetch the AWS documentation page containing the metrics table.
+
+    Returns:
+        str: HTML content of the documentation page
+    """
+    try:
+        response = requests.get(DOCS_URL, timeout=10)
+        response.raise_for_status()
+        return response.text
+    except requests.RequestException as e:
+        logger.error(f'Failed to fetch documentation page: {e}')
+        raise
+
+
+def parse_metrics_table(html_content: str) -> List[Dict[str, Any]]:
+    """Parse the metrics table from the HTML content.
+
+    Args:
+        html_content: HTML content of the documentation page
+
+    Returns:
+        List[Dict[str, Any]]: List of metrics with their names, dimensions, and descriptions
+    """
+    soup = BeautifulSoup(html_content, 'html.parser')
+
+    # Find the metrics table
+    # Use a function that returns a boolean to avoid type issues
+    def table_id_matcher(x: str) -> bool:
+        return bool(x and 'w420aac24b7c33c15b7' in x)
+
+    table = soup.find('table', id=table_id_matcher)
+    if not table:
+        logger.error('Metrics table not found in the documentation page')
+        raise ValueError('Metrics table not found')
+
+    metrics = []
+    rows = table.find_all('tr') if isinstance(table, Tag) else []
+
+    # Skip the header row
+    for row in rows[1:]:
+        cells = row.find_all('td') if isinstance(row, Tag) else []
+        if len(cells) == 3:
+            # Extract metric name
+            metric_name_cell = cells[0]
+            metric_name_element = None
+            if isinstance(metric_name_cell, Tag):
+                metric_name_element = metric_name_cell.find('code', attrs={'class': 'code'})
+
+            if not metric_name_element:
+                continue
+
+            metric_name = (
+                metric_name_element.text.strip() if hasattr(metric_name_element, 'text') else ''
+            )
+
+            # Extract dimensions
+            dimensions_cell = cells[1]
+            dimensions = []
+
+            # Find all paragraph elements in the dimensions cell
+            paragraphs = []
+            if isinstance(dimensions_cell, Tag):
+                paragraphs = dimensions_cell.find_all('p')
+
+            # Process each paragraph
+            for paragraph in paragraphs:
+                # Find all code elements within this paragraph
+                code_elements = []
+                if isinstance(paragraph, Tag):
+                    code_elements = paragraph.find_all('code', attrs={'class': 'code'})
+
+                if len(code_elements) > 1:
+                    # Multiple dimensions in a single paragraph - combine them
+                    combined_dimensions = []
+                    for code in code_elements:
+                        if hasattr(code, 'text'):
+                            combined_dimensions.append(code.text.strip())
+
+                    # Join the dimensions with commas
+                    if combined_dimensions:
+                        dimensions.append(','.join(combined_dimensions))
+                elif len(code_elements) == 1:
+                    # Single dimension in a paragraph
+                    code = code_elements[0]
+                    if hasattr(code, 'text'):
+                        dimension_text = code.text.strip()
+                        if ',' in dimension_text:
+                            # Already comma-separated in the text
+                            dimensions.append(dimension_text)
+                        else:
+                            dimensions.append(dimension_text)
+
+            # Also check for any code elements directly in the cell (not in paragraphs)
+            dimension_codes = []
+            if isinstance(dimensions_cell, Tag):
+                dimension_codes = dimensions_cell.find_all(
+                    'code', attrs={'class': 'code'}, recursive=False
+                )
+
+            for dimension_code in dimension_codes:
+                if hasattr(dimension_code, 'text'):
+                    dimension_text = dimension_code.text.strip()
+                    if dimension_text and dimension_text not in dimensions:
+                        dimensions.append(dimension_text)
+
+            # Extract description
+            description_cell = cells[2]
+            description_element = None
+            if isinstance(description_cell, Tag):
+                description_element = description_cell.find('p')
+
+            if not description_element:
+                continue
+
+            # Get the description and normalize whitespace (replace multiple spaces with a single space)
+            description_text = (
+                description_element.text.strip() if hasattr(description_element, 'text') else ''
+            )
+            description = re.sub(r'\s+', ' ', description_text)
+
+            metrics.append(
+                {'description': description, 'dimensions': dimensions, 'name': metric_name}
+            )
+
+    return metrics
+
+
+def organize_metrics_by_resource_type(
+    metrics: List[Dict[str, Any]],
+) -> Dict[str, Dict[str, List[Dict[str, Any]]]]:
+    """Organize metrics by resource type based on their names.
+
+    Args:
+        metrics: List of metrics with their names, dimensions, and descriptions
+
+    Returns:
+        Dict[str, Dict[str, List[Dict[str, Any]]]]: Metrics organized by resource type
+    """
+    resource_types = {'cluster': [], 'namespace': [], 'node': [], 'pod': [], 'service': []}
+
+    for metric in metrics:
+        name = metric['name']
+
+        # Determine resource type based on metric name prefix
+        if name.startswith('cluster_'):
+            resource_type = 'cluster'
+        elif name.startswith('namespace_'):
+            resource_type = 'namespace'
+        elif name.startswith('node_'):
+            resource_type = 'node'
+        elif name.startswith('pod_'):
+            resource_type = 'pod'
+        elif name.startswith('service_'):
+            resource_type = 'service'
+        else:
+            logger.warning(f'Unknown resource type for metric: {name}')
+            continue
+
+        resource_types[resource_type].append(metric)
+
+    # Convert to the required format
+    result = {}
+    for resource_type, metrics_list in resource_types.items():
+        result[resource_type] = {'metrics': metrics_list}
+
+    return result
+
+
+def load_existing_metrics() -> Dict[str, Any]:
+    """Load existing metrics from the JSON file.
+
+    Returns:
+        Dict[str, Any]: Existing metrics data
+    """
+    try:
+        with open(METRICS_FILE_PATH, 'r') as f:
+            return json.load(f)
+    except (FileNotFoundError, json.JSONDecodeError) as e:
+        logger.warning(f'Failed to load existing metrics file: {e}')
+        return {}
+
+
+def save_metrics(metrics_data: Dict[str, Any]) -> None:
+    """Save metrics data to the JSON file.
+
+    Args:
+        metrics_data: Metrics data to save
+    """
+    try:
+        with open(METRICS_FILE_PATH, 'w') as f:
+            json.dump(metrics_data, f, indent=2)
+        logger.info(f'Metrics data saved to {METRICS_FILE_PATH}')
+    except IOError as e:
+        logger.error(f'Failed to save metrics data: {e}')
+        raise
+
+
+def main() -> None:
+    """Main function to update the metrics guidance JSON file."""
+    logger.info('Starting CloudWatch metrics guidance update')
+
+    try:
+        # Fetch the documentation page
+        logger.info(f'Fetching documentation from {DOCS_URL}')
+        html_content = fetch_documentation_page()
+
+        # Parse the metrics table
+        logger.info('Parsing metrics table')
+        metrics = parse_metrics_table(html_content)
+        logger.info(f'Found {len(metrics)} metrics in the documentation')
+
+        # Organize metrics by resource type
+        logger.info('Organizing metrics by resource type')
+        organized_metrics = organize_metrics_by_resource_type(metrics)
+
+        # Load existing metrics for comparison
+        existing_metrics = load_existing_metrics()
+
+        # Check if there are any changes
+        if existing_metrics == organized_metrics:
+            logger.info('No changes detected in metrics data')
+        else:
+            # Save the updated metrics
+            logger.info('Changes detected in metrics data, updating file')
+            save_metrics(organized_metrics)
+            logger.info('Metrics guidance JSON file updated successfully')
+
+    except Exception as e:
+        logger.error(f'Failed to update metrics guidance: {e}')
+        raise
+
+
+if __name__ == '__main__':
+    main()

awslabs/eks_mcp_server/server.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# 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
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# 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.
 
 """awslabs EKS MCP Server implementation.
 
@@ -22,6 +25,7 @@ Environment Variables:
 
 import argparse
 from awslabs.eks_mcp_server.cloudwatch_handler import CloudWatchHandler
+from awslabs.eks_mcp_server.cloudwatch_metrics_guidance_handler import CloudWatchMetricsHandler
 from awslabs.eks_mcp_server.eks_kb_handler import EKSKnowledgeBaseHandler
 from awslabs.eks_mcp_server.eks_stack_handler import EksStackHandler
 from awslabs.eks_mcp_server.iam_handler import IAMHandler
@@ -36,6 +40,10 @@ SERVER_INSTRUCTIONS = """
 
 This MCP server provides tools for managing Amazon EKS clusters and is the preferred mechanism for creating new EKS clusters.
 
+## IMPORTANT: Use MCP Tools for EKS and Kubernetes Operations
+
+DO NOT use standard EKS and Kubernetes CLI commands (aws eks, eksctl, kubectl). Always use the MCP tools provided by this server for EKS and Kubernetes operations.
+
 ## Usage Notes
 
 - By default, the server runs in read-only mode. Use the `--allow-write` flag to enable write operations.
@@ -57,7 +65,7 @@ This MCP server provides tools for managing Amazon EKS clusters and is the prefe
 1. Check pod status: `list_k8s_resources(cluster_name='my-cluster', kind='Pod', api_version='v1', namespace='default', field_selector='metadata.name=my-pod')`
 2. Get pod events: `get_k8s_events(cluster_name='my-cluster', kind='Pod', name='my-pod', namespace='default')`
 3. Check pod logs: `get_pod_logs(cluster_name='my-cluster', namespace='default', pod_name='my-pod')`
-4. Monitor metrics: `get_cloudwatch_metrics(resource_type='pod', resource_name='my-pod', cluster_name='my-cluster', metric_name='cpu_usage_total', namespace='ContainerInsights')`
+4. Monitor metrics: `get_cloudwatch_metrics(cluster_name='my-cluster', metric_name='cpu_usage_total', namespace='ContainerInsights', dimensions={'ClusterName': 'my-cluster', 'PodName': 'my-pod', 'Namespace': 'default'})`
 5. Search troubleshooting guide: `search_eks_troubleshoot_guide(query='pod pending')`
 
 ## Best Practices
@@ -140,6 +148,7 @@ def main():
     EksStackHandler(mcp, allow_write)
     K8sHandler(mcp, allow_write, allow_sensitive_data_access)
     IAMHandler(mcp, allow_write)
+    CloudWatchMetricsHandler(mcp)
 
     # Run server
     mcp.run()

{awslabs_eks_mcp_server-0.1.2.dist-info → awslabs_eks_mcp_server-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.eks-mcp-server
-Version: 0.1.2
+Version: 0.1.4
 Summary: An AWS Labs Model Context Protocol (MCP) server for EKS
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/eks-mcp-server/
@@ -90,10 +90,11 @@ For read operations, the following permissions are required:
 ### Write Operations Policy
 
 For write operations, we recommend the following IAM policies to ensure successful deployment of EKS clusters using the CloudFormation template in `/awslabs/eks_mcp_server/templates/eks-templates/eks-with-vpc.yaml`:
-- [**IAMFullAccess**](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/IAMFullAccess.html): Enables creation and management of IAM roles and policies required for cluster operation
-- [**AmazonVPCFullAccess**](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonVPCFullAccess.html): Allows creation and configuration of VPC resources including subnets, route tables, internet gateways, and NAT gateways
-- [**AWSCloudFormationFullAccess**](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSCloudFormationFullAccess.html): Provides permissions to create, update, and delete CloudFormation stacks that orchestrate the deployment
-- **EKS Full Access (provided below)**: Required for creating and managing EKS clusters, including control plane configuration, node groups, and add-ons
+
+* [**IAMFullAccess**](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/IAMFullAccess.html): Enables creation and management of IAM roles and policies required for cluster operation
+* [**AmazonVPCFullAccess**](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonVPCFullAccess.html): Allows creation and configuration of VPC resources including subnets, route tables, internet gateways, and NAT gateways
+* [**AWSCloudFormationFullAccess**](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSCloudFormationFullAccess.html): Provides permissions to create, update, and delete CloudFormation stacks that orchestrate the deployment
+* **EKS Full Access (provided below)**: Required for creating and managing EKS clusters, including control plane configuration, node groups, and add-ons
    ```
   {
     "Version": "2012-10-17",
@@ -129,6 +130,30 @@ This quickstart guide walks you through the steps to configure the Amazon EKS MC
 2. Click the gear icon (⚙️) in the top right to open the settings panel, click **MCP**, **Add new global MCP server**.
 3. Paste your MCP server definition. For example, this example shows how to configure the EKS MCP Server, including enabling mutating actions by adding the `--allow-write` flag to the server arguments:
 
+   **For Mac/Linux:**
+
+	```
+	{
+	  "mcpServers": {
+	    "awslabs.eks-mcp-server": {
+	      "autoApprove": [],
+	      "disabled": false,
+	      "command": "uvx",
+	      "args": [
+	        "awslabs.eks-mcp-server@latest",
+	        "--allow-write"
+	      ],
+	      "env": {
+	        "FASTMCP_LOG_LEVEL": "ERROR"
+	      },
+	      "transportType": "stdio"
+	    }
+	  }
+	}
+	```
+
+   **For Windows:**
+
 	```
 	{
 	  "mcpServers": {
@@ -137,7 +162,9 @@ This quickstart guide walks you through the steps to configure the Amazon EKS MC
 	      "disabled": false,
 	      "command": "uvx",
 	      "args": [
+	        "--from",
 	        "awslabs.eks-mcp-server@latest",
+	        "awslabs.eks-mcp-server.exe",
 	        "--allow-write"
 	      ],
 	      "env": {
@@ -158,6 +185,8 @@ This quickstart guide walks you through the steps to configure the Amazon EKS MC
 1. Install the [Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html) .
 2. The Q Developer CLI supports MCP servers for tools and prompts out-of-the-box. Edit your Q developer CLI's MCP configuration file named mcp.json following [these instructions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html). For example:
 
+   **For Mac/Linux:**
+
 	```
 	{
 	  "mcpServers": {
@@ -174,6 +203,24 @@ This quickstart guide walks you through the steps to configure the Amazon EKS MC
 	}
 	```
 
+   **For Windows:**
+
+	```
+	{
+	  "mcpServers": {
+	    "awslabs.eks-mcp-server": {
+	      "command": "uvx",
+	      "args": ["--from", "awslabs.eks-mcp-server@latest", "awslabs.eks-mcp-server.exe"],
+	      "env": {
+	        "FASTMCP_LOG_LEVEL": "ERROR"
+	      },
+	      "autoApprove": [],
+	      "disabled": false
+	    }
+	  }
+	}
+	```
+
 3. Verify your setup by running the `/tools` command in the Q Developer CLI to see the available EKS MCP tools.
 
 Note that this is a basic quickstart. You can enable additional capabilities, such as [running MCP servers in containers](https://github.com/awslabs/mcp?tab=readme-ov-file#running-mcp-servers-in-containers) or combining more MCP servers like the [AWS Documentation MCP Server](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/) into a single MCP server definition. To view an example, see the [Installation and Setup](https://github.com/awslabs/mcp?tab=readme-ov-file#installation-and-setup) guide in AWS MCP Servers on GitHub. To view a real-world implementation with application code in context with an MCP server, see the [Server Developer](https://modelcontextprotocol.io/quickstart/server) guide in Anthropic documentation.
@@ -184,6 +231,7 @@ Note that this is a basic quickstart. You can enable additional capabilities, su
 
 The `args` field in the MCP server definition specifies the command-line arguments passed to the server when it starts. These arguments control how the server is executed and configured. For example:
 
+**For Mac/Linux:**
 ```
 {
   "mcpServers": {
@@ -203,11 +251,39 @@ The `args` field in the MCP server definition specifies the command-line argumen
 }
 ```
 
-#### `awslabs.eks-mcp-server@latest` (required)
+**For Windows:**
+```
+{
+  "mcpServers": {
+    "awslabs.eks-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "awslabs.eks-mcp-server@latest",
+        "awslabs.eks-mcp-server.exe",
+        "--allow-write",
+        "--allow-sensitive-data-access"
+      ],
+      "env": {
+        "AWS_PROFILE": "your-profile",
+        "AWS_REGION": "us-east-1"
+      }
+    }
+  }
+}
+```
 
-Specifies the latest package/version specifier for the MCP client config.
+#### Command Format
 
-* Enables MCP server startup and tool registration.
+The command format differs between operating systems:
+
+**For Mac/Linux:**
+* `awslabs.eks-mcp-server@latest` - Specifies the latest package/version specifier for the MCP client config.
+
+**For Windows:**
+* `--from awslabs.eks-mcp-server@latest awslabs.eks-mcp-server.exe` - Windows requires the `--from` flag to specify the package and the `.exe` extension.
+
+Both formats enable MCP server startup and tool registration.
 
 #### `--allow-write` (optional)
 
@@ -401,24 +477,45 @@ Features:
 Parameters:
 
 * cluster_name, log_type (application, host, performance, control-plane, custom), resource_type (pod, node, container, cluster),
-resource_name, minutes (optional), start_time (optional), end_time (optional), limit (optional), filter_pattern (optional), fields (optional)
+resource_name (optional), minutes (optional), start_time (optional), end_time (optional), limit (optional), filter_pattern (optional), fields (optional)
 
 #### `get_cloudwatch_metrics`
 
-Retrieves metrics from CloudWatch for a specific EKS cluster resource.
+Retrieves metrics from CloudWatch for Kubernetes resources.
 
 Features:
 
-* Fetches metrics based on resource type (pod, node, container, cluster), resource name, and metric name.
-* Allows specification of CloudWatch namespace, Kubernetes namespace, and time range.
+* Fetches metrics based on metric name and dimensions.
+* Allows specification of CloudWatch namespace and time range.
 * Configurable period, statistic (Average, Sum, etc.), and limit for data points.
 * Supports providing custom dimensions for fine-grained metric querying.
 
 Parameters:
 
-* cluster_name, metric_name, resource_type (pod, node, container, cluster), resource_name, namespace (optional), k8s_namespace
-(optional), minutes (optional), start_time (optional), end_time (optional), limit (optional), stat (optional), period (optional), custom_dimensions
- (optional)
+* cluster_name, metric_name, namespace, dimensions, minutes (optional), start_time (optional), end_time (optional), limit (optional), stat (optional), period (optional)
+
+#### `get_eks_metrics_guidance`
+
+Provides guidance on available CloudWatch metrics for different resource types in EKS clusters.
+
+Features:
+
+* Returns a list of available Container Insights metrics for the specified resource type, including metric names, dimensions, and descriptions.
+* Helps determine the correct dimensions to use with the `get_cloudwatch_metrics` tool.
+* Supports the following resource types:
+  * `cluster`: Metrics for EKS clusters (e.g., cluster_node_count, cluster_failed_node_count)
+  * `node`: Metrics for EKS nodes (e.g., node_cpu_utilization, node_memory_utilization, node_network_total_bytes)
+  * `pod`: Metrics for Kubernetes pods (e.g., pod_cpu_utilization, pod_memory_utilization, pod_network_rx_bytes)
+  * `namespace`: Metrics for Kubernetes namespaces (e.g., namespace_number_of_running_pods)
+  * `service`: Metrics for Kubernetes services (e.g., service_number_of_running_pods)
+
+Parameters:
+
+* resource_type
+
+Implementation:
+
+The data in `/awslabs/eks_mcp_server/data/eks_cloudwatch_metrics_guidance.json` is generated by a Python script (`/awslabs/eks_mcp_server/scripts/update_eks_cloudwatch_metrics_guidance.py`) that scrapes the [Container Insights metrics table](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-EKS.html) from AWS documentation. Running the script requires installing BeautifulSoup (used for parsing HTML content) with uv: `uv pip install bs4`.
 
 ### IAM Integration
 
@@ -505,6 +602,7 @@ The EKS MCP Server can be used for production environments with proper security
 
 An array within the MCP server definition that lists tool names to be automatically approved by the EKS MCP Server client, bypassing user confirmation for those specific tools. For example:
 
+**For Mac/Linux:**
 ```
 {
   "mcpServers": {
@@ -535,6 +633,39 @@ An array within the MCP server definition that lists tool names to be automatica
 }
 ```
 
+**For Windows:**
+```
+{
+  "mcpServers": {
+    "awslabs.eks-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "awslabs.eks-mcp-server@latest",
+        "awslabs.eks-mcp-server.exe"
+      ],
+      "env": {
+        "AWS_PROFILE": "eks-mcp-readonly-profile",
+        "AWS_REGION": "us-east-1",
+        "FASTMCP_LOG_LEVEL": "INFO"
+      },
+      "autoApprove": [
+        "manage_eks_stacks",
+        "manage_k8s_resource",
+        "list_k8s_resources",
+        "get_pod_logs",
+        "get_k8s_events",
+        "get_cloudwatch_logs",
+        "get_cloudwatch_metrics",
+        "get_policies_for_role",
+        "search_eks_troubleshoot_guide",
+        "list_api_versions"
+      ]
+    }
+  }
+}
+```
+
 ### IAM Permissions Management
 
 When the `--allow-write` flag is enabled, the EKS MCP Server can create missing IAM permissions for EKS resources through the `add_inline_policy` tool. This tool enables the following:

awslabs_eks_mcp_server-0.1.4.dist-info/RECORD

@@ -0,0 +1,26 @@
+awslabs/__init__.py,sha256=WuqxdDgUZylWNmVoPKiK7qGsTB_G4UmuXIrJ-VBwDew,731
+awslabs/eks_mcp_server/__init__.py,sha256=ghJqbcPKp3-jM8LmEQzU_KRSbVm6yKQFg7C0ZwxAdeA,668
+awslabs/eks_mcp_server/aws_helper.py,sha256=uiH-CSJPo_L903EzmV8HZB6xg_F4Jm_-BmJk_3AAH4g,2850
+awslabs/eks_mcp_server/cloudwatch_handler.py,sha256=k3GsORIFswOknxYM0reCBsCHXn--gSwl7WVtxkUTyzg,28853
+awslabs/eks_mcp_server/cloudwatch_metrics_guidance_handler.py,sha256=b0fFMvsGX98HKK4kVFI1YbhZqZC623lZ6TNXs3EiRSI,5283
+awslabs/eks_mcp_server/consts.py,sha256=XBat-KcMckueQQpDeLkD_Nv_9G9kX0_d48sMEHtZ5HQ,1380
+awslabs/eks_mcp_server/eks_kb_handler.py,sha256=6L3wS500AadKburhwf0zXEapXscd4VZCTY8t61u-j1Y,3548
+awslabs/eks_mcp_server/eks_stack_handler.py,sha256=gbZizqaumsAz5x-fLM-VJlmUCzTp7TwtbOGn8u6_omc,29721
+awslabs/eks_mcp_server/iam_handler.py,sha256=t2QIJVP61lAVTiTB9VCko9RDXjAtz8nuXr_MRdKG9pw,14586
+awslabs/eks_mcp_server/k8s_apis.py,sha256=YRx29w-7n3LX3DsniPgULuxNx_6Mkw-Jzh-PGetZDag,20448
+awslabs/eks_mcp_server/k8s_client_cache.py,sha256=Nh8V6IXvWltQwiBhFk8KgDUggmf9dqQ-sR3kENBnecM,5871
+awslabs/eks_mcp_server/k8s_handler.py,sha256=vA08ONRDky7S5hINif8hxe_Y1KAArQDzOao1YLf4Uck,49447
+awslabs/eks_mcp_server/logging_helper.py,sha256=hr8xZhAZOKyR7dkwc7bhqkDVuSDI3BRK3-UzllQkWgE,1854
+awslabs/eks_mcp_server/models.py,sha256=UtMmZaRJNjV8I9A8jCD9vzU66tXYOLna8RzaMNQPddE,11930
+awslabs/eks_mcp_server/server.py,sha256=UHKhCEgR7D5pXpH1xnpMyOfRLZ9o9d327n5c311erGI,6704
+awslabs/eks_mcp_server/data/eks_cloudwatch_metrics_guidance.json,sha256=a4tzVdwpF_0kZGwOJCDEQskScp5rjRU89M7ONp3HpdA,9304
+awslabs/eks_mcp_server/scripts/update_eks_cloudwatch_metrics_guidance.py,sha256=Y1OvU85wc3WIviUbabbGCCO-DvJwtP2UU9ABuEMSNyY,10099
+awslabs/eks_mcp_server/templates/eks-templates/eks-with-vpc.yaml,sha256=_Lxk2MEXNA7N0-kvXckxwBamDEagjGvC6-Z5uxhVO5s,10774
+awslabs/eks_mcp_server/templates/k8s-templates/deployment.yaml,sha256=J2efYFISlT3sTvf8_BJV3p0_m51cltqiRhXdBXb9YJs,2343
+awslabs/eks_mcp_server/templates/k8s-templates/service.yaml,sha256=DA0Db_5yjUZmnnYy5Bljcv3hj7D6YvFFWFRB6GiIstY,414
+awslabs_eks_mcp_server-0.1.4.dist-info/METADATA,sha256=E8OHB-NvW_u6p-z4eHytjP5k3fBlPv0HZGIhdp3_1mk,29163
+awslabs_eks_mcp_server-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_eks_mcp_server-0.1.4.dist-info/entry_points.txt,sha256=VydotfOJYck8o4TPsaF6Pjmc8Bp_doacYXSE_71qH4c,78
+awslabs_eks_mcp_server-0.1.4.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_eks_mcp_server-0.1.4.dist-info/licenses/NOTICE,sha256=gnCtD34qTDnb2Lykm9kNFYkqZIvqJHGuq1ZJBkl6EgE,90
+awslabs_eks_mcp_server-0.1.4.dist-info/RECORD,,

awslabs_eks_mcp_server-0.1.2.dist-info/RECORD

@@ -1,23 +0,0 @@
-awslabs/__init__.py,sha256=47wJeKcStxEJwX7SVVV2pnAWYR8FxcaYoT3YTmZ5Plg,674
-awslabs/eks_mcp_server/__init__.py,sha256=ClxsTrvClkBctqdiivFNI1oYee4M8mHm0E2jlQxmw_Y,611
-awslabs/eks_mcp_server/aws_helper.py,sha256=eN8T-khiUVBHlab4PBcuLSErW7Q_dqG6J8Mtm9ukyEw,2793
-awslabs/eks_mcp_server/cloudwatch_handler.py,sha256=ZwWsym2zn4a9ounIXVrB4Xsw9I4TbzkHk5a9eotO-so,28874
-awslabs/eks_mcp_server/consts.py,sha256=tYxCxyDQy_Y1W__U6BeyBsB0Rcz3cTj-meWdJtIzPeE,1323
-awslabs/eks_mcp_server/eks_kb_handler.py,sha256=h5xEo_-X_lMt7ifZmfJm9PiEOkR_85j5BsS5ivskv88,3489
-awslabs/eks_mcp_server/eks_stack_handler.py,sha256=CeQuUNtGOT_cMAIOYjzCAZs7ZtLG7VKAS4agC-N2ZkQ,29237
-awslabs/eks_mcp_server/iam_handler.py,sha256=hRF_YUwjHP-QAQkJOoutjsvTJungBCY0ouMAznXdPug,14266
-awslabs/eks_mcp_server/k8s_apis.py,sha256=lo13Uc-1XaY4RuHhsezeU1WZg6jHcb31OS9ZYPHkQec,20203
-awslabs/eks_mcp_server/k8s_client_cache.py,sha256=KFlDt6_tq1PjhGhOy1Q4EOMyK0NkPu6xKzZf4ciGFvI,5814
-awslabs/eks_mcp_server/k8s_handler.py,sha256=PJUrLdqf8yWdpik6XQZjWwl-SSuhCMT3ktATd8-G-dg,48930
-awslabs/eks_mcp_server/logging_helper.py,sha256=p_7SbWclTIVQNcQvPf5jP7OSFEJNOFbSq9b1U4v6Cxw,1797
-awslabs/eks_mcp_server/models.py,sha256=YlTuQeweBlqt0aBPfK27_OFWhq4XFD023BBjbTPJWnY,11575
-awslabs/eks_mcp_server/server.py,sha256=PDoyTTkhYs_Saqp4uo1M-4jVT6H7ZWvw7MTLIIl7P_E,6247
-awslabs/eks_mcp_server/templates/eks-templates/eks-with-vpc.yaml,sha256=_Lxk2MEXNA7N0-kvXckxwBamDEagjGvC6-Z5uxhVO5s,10774
-awslabs/eks_mcp_server/templates/k8s-templates/deployment.yaml,sha256=J2efYFISlT3sTvf8_BJV3p0_m51cltqiRhXdBXb9YJs,2343
-awslabs/eks_mcp_server/templates/k8s-templates/service.yaml,sha256=DA0Db_5yjUZmnnYy5Bljcv3hj7D6YvFFWFRB6GiIstY,414
-awslabs_eks_mcp_server-0.1.2.dist-info/METADATA,sha256=ka7LZj3o5jeY6Nsdtllq4PkbBNTnd4bTFjzCQVLHZCc,25687
-awslabs_eks_mcp_server-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_eks_mcp_server-0.1.2.dist-info/entry_points.txt,sha256=VydotfOJYck8o4TPsaF6Pjmc8Bp_doacYXSE_71qH4c,78
-awslabs_eks_mcp_server-0.1.2.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
-awslabs_eks_mcp_server-0.1.2.dist-info/licenses/NOTICE,sha256=gnCtD34qTDnb2Lykm9kNFYkqZIvqJHGuq1ZJBkl6EgE,90
-awslabs_eks_mcp_server-0.1.2.dist-info/RECORD,,