awslabs.cost-explorer-mcp-server 0.0.5__tar.gz → 0.0.7__tar.gz

{awslabs_cost_explorer_mcp_server-0.0.5 → awslabs_cost_explorer_mcp_server-0.0.7}/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2025-06-20
+
+### Added
+- **NEW AWS Cost Comparison Feature Integration**
+- `get_cost_and_usage_comparisons` - Leverage AWS Cost Explorer's new Cost Comparison feature to compare costs between two time periods
+- `get_cost_comparison_drivers` - Automatically analyze the top 10 most significant cost change drivers using AWS's new API
+- Reduces manual cost analysis time from hours to seconds using AWS's built-in intelligence
+- Provides detailed breakdowns of cost drivers, including usage and discount changes
+**Cost Forecasting Capabilities**
+- `get_cost_forecast` - Generate cost forecasts based on historical usage patterns with confidence intervals (80% or 95%)
+- Support for daily and monthly forecast granularity for budget planning
+**Modular Architecture**
+- Refactored codebase into modular handler architecture for better maintainability
+- Separate handlers for cost usage, comparison, forecasting, metadata, and utility functions
+**Enhanced Testing**
+- Comprehensive test coverage for comparison features
+- Fixed duplicate test method definitions
+- Improved test reliability and error handling
+
 ## [0.5.0] - 2025-06-16
 
 ### Added

{awslabs_cost_explorer_mcp_server-0.0.5 → awslabs_cost_explorer_mcp_server-0.0.7}/Dockerfile

@@ -12,7 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-FROM public.ecr.aws/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65 AS uv
+# dependabot should continue to update this to the latest hash.
+FROM public.ecr.aws/docker/library/python:3.13.5-alpine3.21@sha256:c9a09c45a4bcc618c7f7128585b8dd0d41d0c31a8a107db4c8255ffe0b69375d AS uv
 
 # Install the project into `/app`
 WORKDIR /app
@@ -30,56 +31,58 @@ ENV UV_PYTHON_PREFERENCE=only-system
 ENV UV_FROZEN=true
 
 # Copy the required files first
-COPY pyproject.toml uv.lock ./
+COPY pyproject.toml uv.lock uv-requirements.txt ./
+
+# Python optimization and uv configuration
+ENV PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Install system dependencies and Python package manager
+RUN apk update && \
+    apk add --no-cache --virtual .build-deps \
+    build-base \
+    gcc \
+    musl-dev \
+    libffi-dev \
+    openssl-dev \
+    cargo
 
 # Install the project's dependencies using the lockfile and settings
 RUN --mount=type=cache,target=/root/.cache/uv \
-    pip install uv && \
-    uv sync --frozen --no-install-project --no-dev --no-editable
+    pip install --require-hashes --requirement uv-requirements.txt --no-cache-dir && \
+    uv sync --python 3.13 --frozen --no-install-project --no-dev --no-editable
 
 # Then, add the rest of the project source code and install it
 # Installing separately from its dependencies allows optimal layer caching
 COPY . /app
 RUN --mount=type=cache,target=/root/.cache/uv \
-    uv sync --frozen --no-dev --no-editable
+    uv sync --python 3.13 --frozen --no-dev --no-editable
 
 # Make the directory just in case it doesn't exist
 RUN mkdir -p /root/.local
 
-FROM public.ecr.aws/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65
+FROM public.ecr.aws/docker/library/python:3.13.5-alpine3.21@sha256:c9a09c45a4bcc618c7f7128585b8dd0d41d0c31a8a107db4c8255ffe0b69375d
 
 # Place executables in the environment at the front of the path and include other binaries
-ENV PATH="/app/.venv/bin:$PATH:/usr/sbin"
-
-# Set environment variables
-ENV PYTHONUNBUFFERED=1 \
-    PYTHONDONTWRITEBYTECODE=1 \
-    FASTMCP_LOG_LEVEL=INFO
-
-# Install lsof for the healthcheck
-# Install other tools as needed for the MCP server
-# Add non-root user and ability to change directory into /root
-RUN yum update -y && \
-    yum install -y lsof && \
-    yum clean all -y && \
-    rm -rf /var/cache/yum && \
-    groupadd --force --system app && \
-    useradd app -g app -d /app && \
-    chmod o+x /root
-
-# Get the project from the uv layer
-COPY --from=uv --chown=app:app /root/.local /root/.local
+ENV PATH="/app/.venv/bin:$PATH" \
+    PYTHONUNBUFFERED=1
+
+# Install runtime dependencies and create application user
+RUN apk update && \
+    apk add --no-cache ca-certificates && \
+    update-ca-certificates && \
+    addgroup -S app && \
+    adduser -S app -G app -h /app
+
+# Copy application artifacts from build stage
 COPY --from=uv --chown=app:app /app/.venv /app/.venv
 
 # Get healthcheck script
 COPY ./docker-healthcheck.sh /usr/local/bin/docker-healthcheck.sh
-RUN chmod +x /usr/local/bin/docker-healthcheck.sh
 
 # Run as non-root
 USER app
 
-# Health check
-HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD [ "docker-healthcheck.sh" ]
-
-# Use entrypoint instead of CMD
+# When running the container, add --db-path and a bind mount to the host's db file
+HEALTHCHECK --interval=60s --timeout=10s --start-period=10s --retries=3 CMD ["docker-healthcheck.sh"]
 ENTRYPOINT ["awslabs.cost-explorer-mcp-server"]

{awslabs_cost_explorer_mcp_server-0.0.5 → awslabs_cost_explorer_mcp_server-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cost-explorer-mcp-server
-Version: 0.0.5
+Version: 0.0.7
 Summary: MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer API
 Project-URL: Homepage, https://awslabs.github.io/mcp/
 Project-URL: Documentation, https://awslabs.github.io/mcp/servers/cost-explorer-mcp-server/
@@ -21,9 +21,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
-Requires-Dist: boto3>=1.36.20
+Requires-Dist: boto3>=1.38.40
 Requires-Dist: loguru>=0.7.0
-Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: mcp[cli]>=1.11.0
 Requires-Dist: pandas>=2.2.3
 Requires-Dist: pydantic>=2.10.6
 Description-Content-Type: text/markdown
@@ -41,17 +41,28 @@ MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer
 - Query historical cost data for specific time periods
 - Filter costs by various dimensions, tags, and cost categories
 
+
+### Compare costs between time periods
+
+- **NEW AWS Feature**: Leverage AWS Cost Explorer's new [Cost Comparison feature](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-cost-comparison.html)
+- Compare costs between two time periods to identify changes and trends
+- Analyze cost drivers to understand what caused cost increases or decreases
+- Get detailed insights into the top 10 most significant cost change drivers automatically
+- Identify specific usage types, discount changes, and infrastructure changes affecting costs
+
+### Forecast future costs
+
+- Generate cost forecasts based on historical usage patterns
+- Get predictions with confidence intervals (80% or 95%)
+- Support for daily and monthly forecast granularity
+- Plan budgets and anticipate future AWS spending
+
 ### Query cost data with natural language
 
 - Ask questions about your AWS costs in plain English
 - Get instant answers about your AWS spending patterns
 - Retrieve historical cost data with simple queries
 
-### Generate cost reports and insights
-
-- Generate comprehensive cost reports based on your AWS Cost Explorer data
-- Get cost breakdowns by various dimensions (service, region, account, etc.)
-- Analyze usage patterns and spending trends
 
 ## Prerequisites
 
@@ -64,7 +75,9 @@ MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer
 
 ## Installation
 
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.cost-explorer-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuY29zdC1leHBsb3Jlci1tY3Atc2VydmVyQGxhdGVzdCIsImVudiI6eyJGQVNUTUNQX0xPR19MRVZFTCI6IkVSUk9SIiwiQVdTX1BST0ZJTEUiOiJ5b3VyLWF3cy1wcm9maWxlIn0sImRpc2FibGVkIjpmYWxzZSwiYXV0b0FwcHJvdmUiOltdfQ%3D%3D)
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.cost-explorer-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuY29zdC1leHBsb3Jlci1tY3Atc2VydmVyQGxhdGVzdCIsImVudiI6eyJBV1NfUFJPRklMRSI6InlvdXItYXdzLXByb2ZpbGUiLCJBV1NfUkVHSU9OIjoidXMtZWFzdC0xIiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [![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=Cost%20Explorer%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.cost-explorer-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22your-aws-profile%22%2C%22AWS_REGION%22%3A%22us-east-1%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
 
 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`):
 
@@ -149,6 +162,9 @@ The following IAM permissions are required for this MCP server:
 - ce:GetCostAndUsage
 - ce:GetDimensionValues
 - ce:GetTags
+- ce:GetCostForecast
+- ce:GetCostAndUsageComparisons
+- ce:GetCostComparisonDrivers
 
 
 
@@ -160,26 +176,39 @@ The Cost Explorer MCP Server provides the following tools:
 2. `get_dimension_values` - Get available values for a specific dimension (e.g., SERVICE, REGION)
 3. `get_tag_values` - Get available values for a specific tag key
 4. `get_cost_and_usage` - Retrieve AWS cost and usage data with filtering and grouping options
+5. `get_cost_and_usage_comparisons` - Compare costs between two time periods to identify changes and trends
+6. `get_cost_comparison_drivers` - Analyze what drove cost changes between periods (top 10 most significant drivers)
+7. `get_cost_forecast` - Generate cost forecasts based on historical usage patterns
 
 ## Example Usage
 
-Here are some examples of how to use the Cost Explorer MCP Server:
-
+Here are some examples of how to use the Cost Explorer MCP Server through natural language queries:
 
-### Get dimension values
+### Cost Analysis Examples
 
 ```
-What AWS services did I use last month?
+Show me my AWS costs for the last 3 months grouped by service in us-east-1 region
+Break down my S3 costs by storage class for Q1 2025
+Show me costs for production resources tagged with Environment=prod
+What were my costs for reserved instances vs on-demand in May?
+What was my EC2 instance usage by instance type?
 ```
 
-### Generate a cost report
+### Cost Comparison Examples
 
 ```
-Show me my AWS costs for the last 3 months grouped by service in us-east-1 region
+Compare my AWS costs between April and May 2025
+How did my EC2 costs change from last month to this month?
+Why did my AWS bill increase in June compared to May?
+What caused the spike in my S3 costs last month?
 ```
 
+### Forecasting Examples
+
 ```
-What were my EC2 costs excluding us-east-2 for January 2025?
+Forecast my AWS costs for next month
+Predict my EC2 spending for the next quarter
+What will my total AWS bill be for the rest of 2025?
 ```
 
 ## License

{awslabs_cost_explorer_mcp_server-0.0.5 → awslabs_cost_explorer_mcp_server-0.0.7}/README.md

@@ -11,17 +11,28 @@ MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer
 - Query historical cost data for specific time periods
 - Filter costs by various dimensions, tags, and cost categories
 
+
+### Compare costs between time periods
+
+- **NEW AWS Feature**: Leverage AWS Cost Explorer's new [Cost Comparison feature](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-cost-comparison.html)
+- Compare costs between two time periods to identify changes and trends
+- Analyze cost drivers to understand what caused cost increases or decreases
+- Get detailed insights into the top 10 most significant cost change drivers automatically
+- Identify specific usage types, discount changes, and infrastructure changes affecting costs
+
+### Forecast future costs
+
+- Generate cost forecasts based on historical usage patterns
+- Get predictions with confidence intervals (80% or 95%)
+- Support for daily and monthly forecast granularity
+- Plan budgets and anticipate future AWS spending
+
 ### Query cost data with natural language
 
 - Ask questions about your AWS costs in plain English
 - Get instant answers about your AWS spending patterns
 - Retrieve historical cost data with simple queries
 
-### Generate cost reports and insights
-
-- Generate comprehensive cost reports based on your AWS Cost Explorer data
-- Get cost breakdowns by various dimensions (service, region, account, etc.)
-- Analyze usage patterns and spending trends
 
 ## Prerequisites
 
@@ -34,7 +45,9 @@ MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer
 
 ## Installation
 
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.cost-explorer-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuY29zdC1leHBsb3Jlci1tY3Atc2VydmVyQGxhdGVzdCIsImVudiI6eyJGQVNUTUNQX0xPR19MRVZFTCI6IkVSUk9SIiwiQVdTX1BST0ZJTEUiOiJ5b3VyLWF3cy1wcm9maWxlIn0sImRpc2FibGVkIjpmYWxzZSwiYXV0b0FwcHJvdmUiOltdfQ%3D%3D)
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.cost-explorer-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuY29zdC1leHBsb3Jlci1tY3Atc2VydmVyQGxhdGVzdCIsImVudiI6eyJBV1NfUFJPRklMRSI6InlvdXItYXdzLXByb2ZpbGUiLCJBV1NfUkVHSU9OIjoidXMtZWFzdC0xIiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [![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=Cost%20Explorer%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.cost-explorer-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22your-aws-profile%22%2C%22AWS_REGION%22%3A%22us-east-1%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
 
 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`):
 
@@ -119,6 +132,9 @@ The following IAM permissions are required for this MCP server:
 - ce:GetCostAndUsage
 - ce:GetDimensionValues
 - ce:GetTags
+- ce:GetCostForecast
+- ce:GetCostAndUsageComparisons
+- ce:GetCostComparisonDrivers
 
 
 
@@ -130,26 +146,39 @@ The Cost Explorer MCP Server provides the following tools:
 2. `get_dimension_values` - Get available values for a specific dimension (e.g., SERVICE, REGION)
 3. `get_tag_values` - Get available values for a specific tag key
 4. `get_cost_and_usage` - Retrieve AWS cost and usage data with filtering and grouping options
+5. `get_cost_and_usage_comparisons` - Compare costs between two time periods to identify changes and trends
+6. `get_cost_comparison_drivers` - Analyze what drove cost changes between periods (top 10 most significant drivers)
+7. `get_cost_forecast` - Generate cost forecasts based on historical usage patterns
 
 ## Example Usage
 
-Here are some examples of how to use the Cost Explorer MCP Server:
-
+Here are some examples of how to use the Cost Explorer MCP Server through natural language queries:
 
-### Get dimension values
+### Cost Analysis Examples
 
 ```
-What AWS services did I use last month?
+Show me my AWS costs for the last 3 months grouped by service in us-east-1 region
+Break down my S3 costs by storage class for Q1 2025
+Show me costs for production resources tagged with Environment=prod
+What were my costs for reserved instances vs on-demand in May?
+What was my EC2 instance usage by instance type?
 ```
 
-### Generate a cost report
+### Cost Comparison Examples
 
 ```
-Show me my AWS costs for the last 3 months grouped by service in us-east-1 region
+Compare my AWS costs between April and May 2025
+How did my EC2 costs change from last month to this month?
+Why did my AWS bill increase in June compared to May?
+What caused the spike in my S3 costs last month?
 ```
 
+### Forecasting Examples
+
 ```
-What were my EC2 costs excluding us-east-2 for January 2025?
+Forecast my AWS costs for next month
+Predict my EC2 spending for the next quarter
+What will my total AWS bill be for the rest of 2025?
 ```
 
 ## License