awslabs.aws-support-mcp-server 0.1.2__tar.gz

awslabs_aws_support_mcp_server-0.1.2/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: awslabs.aws-support-mcp-server
+Version: 0.1.2
+Summary: An Model Context Protocol (MCP) server for AWS SupportAPI.
+Author: Amazon Web Services
+Author-email: John de Villiers <jackdevilliers.work@gmail.com>
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: boto3>=1.38.12
+Requires-Dist: fastmcp>=2.3.4
+Requires-Dist: langdetect>=1.0.9
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: markdownify>=0.13.1
+Requires-Dist: mcp[cli]>=1.8.0
+Requires-Dist: pre-commit>=4.2.0
+Requires-Dist: protego>=0.3.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pytest>=8.3.5
+Requires-Dist: pytest-asyncio>=0.26.0
+Requires-Dist: pytest-cov>=6.1.1
+Requires-Dist: readabilipy>=0.2.0
+Requires-Dist: requests>=2.32.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.0.291; extra == "dev"
+Requires-Dist: pyright>=1.1.350; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
+
+# AWS Support MCP Server
+
+A Model Context Protocol (MCP) server implementation for interacting with the AWS Support API. This server enables AI assistants to create and manage AWS support cases programmatically.
+
+## Features
+
+- Create and manage AWS support cases
+- Retrieve case information and communications
+- Add communications to existing cases
+- Resolve support cases
+- Determine appropriate Issue Type, Service Code, and Category Code
+- Determine appropriate Severity Level for a case
+
+
+## Requirements
+
+- Python 3.7+
+- AWS credentials with Support API access
+- Business, Enterprise On-Ramp, or Enterprise Support plan
+
+## Prerequisites
+
+1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
+2. Install Python using `uv python install 3.10`
+
+## Installation
+
+Here are some ways you can work with MCP across AWS, and we'll be adding support to more products including Amazon Q Developer CLI soon: (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
+```json
+
+{
+   "mcpServers": {
+      "awslabs_support_mcp_server": {
+         "command": "uvx",
+         "args": [
+            "-m", "awslabs.aws-support-mcp-server@latest",
+            "--debug",
+            "--log-file",
+            "./logs/mcp_support_server.log"
+         ],
+         "env": {
+            "AWS_PROFILE": "your-aws-profile"
+         }
+      }
+   }
+}
+```
+
+Alternatively:
+```bash
+
+
+uv pip install -e .
+uv run awslabs/aws_support_mcp_server/server.py
+```
+
+```json
+{
+   "mcpServers": {
+      "awslabs_support_mcp_server": {
+         "command": "path-to-python",
+         "args": [
+            "-m",
+            "awslabs.aws_support_mcp_server.server",
+            "--debug",
+            "--log-file",
+            "./logs/mcp_support_server.log"
+         ],
+         "env": {
+            "AWS_PROFILE": "manual_enterprise"
+         }
+      }
+   }
+}
+```
+
+## Usage
+
+Start the server:
+
+```bash
+python -m awslabs.aws_support_mcp_server.server [options]
+```
+
+Options:
+- `--port PORT`: Port to run the server on (default: 8888)
+- `--debug`: Enable debug logging
+- `--log-file`: Where to save the log file
+
+## Configuration
+
+The server can be configured using environment variables:
+
+- `AWS_REGION`: AWS region (default: us-east-1)
+- `AWS_PROFILE`: AWS credentials profile name
+
+## Documentation
+
+For detailed documentation on available tools and resources, see the [API Documentation](docs/api.md).
+
+
+
+## License
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").

awslabs_aws_support_mcp_server-0.1.2/README.md

@@ -0,0 +1,107 @@
+# AWS Support MCP Server
+
+A Model Context Protocol (MCP) server implementation for interacting with the AWS Support API. This server enables AI assistants to create and manage AWS support cases programmatically.
+
+## Features
+
+- Create and manage AWS support cases
+- Retrieve case information and communications
+- Add communications to existing cases
+- Resolve support cases
+- Determine appropriate Issue Type, Service Code, and Category Code
+- Determine appropriate Severity Level for a case
+
+
+## Requirements
+
+- Python 3.7+
+- AWS credentials with Support API access
+- Business, Enterprise On-Ramp, or Enterprise Support plan
+
+## Prerequisites
+
+1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
+2. Install Python using `uv python install 3.10`
+
+## Installation
+
+Here are some ways you can work with MCP across AWS, and we'll be adding support to more products including Amazon Q Developer CLI soon: (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
+```json
+
+{
+   "mcpServers": {
+      "awslabs_support_mcp_server": {
+         "command": "uvx",
+         "args": [
+            "-m", "awslabs.aws-support-mcp-server@latest",
+            "--debug",
+            "--log-file",
+            "./logs/mcp_support_server.log"
+         ],
+         "env": {
+            "AWS_PROFILE": "your-aws-profile"
+         }
+      }
+   }
+}
+```
+
+Alternatively:
+```bash
+
+
+uv pip install -e .
+uv run awslabs/aws_support_mcp_server/server.py
+```
+
+```json
+{
+   "mcpServers": {
+      "awslabs_support_mcp_server": {
+         "command": "path-to-python",
+         "args": [
+            "-m",
+            "awslabs.aws_support_mcp_server.server",
+            "--debug",
+            "--log-file",
+            "./logs/mcp_support_server.log"
+         ],
+         "env": {
+            "AWS_PROFILE": "manual_enterprise"
+         }
+      }
+   }
+}
+```
+
+## Usage
+
+Start the server:
+
+```bash
+python -m awslabs.aws_support_mcp_server.server [options]
+```
+
+Options:
+- `--port PORT`: Port to run the server on (default: 8888)
+- `--debug`: Enable debug logging
+- `--log-file`: Where to save the log file
+
+## Configuration
+
+The server can be configured using environment variables:
+
+- `AWS_REGION`: AWS region (default: us-east-1)
+- `AWS_PROFILE`: AWS credentials profile name
+
+## Documentation
+
+For detailed documentation on available tools and resources, see the [API Documentation](docs/api.md).
+
+
+
+## License
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").

awslabs_aws_support_mcp_server-0.1.2/awslabs/__init__.py

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

awslabs_aws_support_mcp_server-0.1.2/awslabs/aws_support_mcp_server/__init__.py

@@ -0,0 +1,16 @@
+"""AWS Support MCP Server package."""
+
+import sys
+
+from loguru import logger
+
+# Configure package-level logging
+logger.remove()
+logger.add(
+    sys.stderr,
+    level="DEBUG",
+    format="<green>{time:YYYY-MM-DD HH:mm:ss.SSS}</green> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
+)
+
+# Export version
+__version__ = "0.1.0"