AWS FinOps MCP Server

AWS FinOps MCP Server

Production-Ready Deployment: This MCP server is optimized for deployment on Amazon Bedrock AgentCore Runtime

Model Context Protocol (MCP) server for AWS Financial Operations (FinOps) - providing comprehensive tools for cloud resource optimization, cost management, and performance monitoring.

🚀 Quick Start - Deploy to AWS

Deploy to Amazon Bedrock AgentCore (Recommended)

Deploy your MCP server to production in minutes:

# 1. Create ECR repository
./create-ecr-repo.sh

# 2. Update configuration
sed -i 's/ecr: auto/ecr: aws-pillar-mcp-server/' .bedrock_agentcore.yaml

# 3. Deploy to AWS
agentcore launch

# 4. Test your deployment
agentcore invoke '{"prompt": "find unused resources in us-east-1"}'

📖 Complete Deployment Guides:

• AGENTCORE_DEPLOYMENT_FINAL.md - Complete deployment guide with troubleshooting
• AGENTCORE_QUICKSTART.md - Quick 5-minute deployment
• AGENTCORE_RUNTIME_REVIEW.md - Status review and next steps
• QUICK_FIX_DEPLOYMENT.md - Quick fixes for common issues
• MANUAL_AGENTCORE_DEPLOY.md - Manual Docker deployment

Local Development

# Install dependencies
pip install -e .

# Run locally
python -m aws_finops_mcp

🎯 Quick Overview

• 76 Tools across 14 categories for comprehensive AWS optimization
• Category Filtering - Load only the tools you need (NEW!)
• Dual Modes - stdio for direct integration, HTTP for remote access
• Cost Savings - Identify unused resources and optimization opportunities
• Security & Compliance - Find unencrypted resources and security issues
• Performance Analysis - Analyze and optimize application performance
• Ready-to-Use IAM Policies - Get started in minutes

📊 View Architecture Diagrams - Visual system architecture and data flows

🆕 What's New

Category-Based Tool Filtering

Problem: Loading all 76 tools can be slow and overwhelming for MCP clients.

Solution: Use MCP_TOOL_CATEGORIES to enable only the categories you need!

# Load only cost and cleanup tools (25 tools instead of 76)
export MCP_TOOL_CATEGORIES="cleanup,cost"
python -m aws_finops_mcp

# 67% reduction in tool count, faster loading, easier navigation

Benefits:

• ⚡ 67-89% faster loading for focused use cases
• 🎯 Better organization - see only relevant tools
• 🔧 Flexible - change categories without code changes
• ✅ Backward compatible - defaults to all tools

📖 See TOOL_CATEGORIES.md for complete guide

New Tools Added

• Network: NAT Gateways, VPC Endpoints, Internet Gateways, CloudFront, Route53
• Storage: S3 buckets, storage class recommendations
• Containers: ECS clusters/services, ECR images, launch templates
• Messaging: SQS queues, SNS topics, EventBridge rules
• Database: DynamoDB tables and utilization
• Monitoring: CloudWatch alarms and dashboards
• Performance: Lambda cold starts, API Gateway, DynamoDB throttling, RDS insights, CloudFront cache
• Security: Unencrypted resources, public S3 buckets, permissive security groups
• Governance: Untagged resources, tag compliance, cost allocation
• Capacity: ElastiCache, ECS services, Lambda utilization
• Upgrade: Lambda runtimes, EC2 generations, EBS types, RDS/ElastiCache engines, EKS versions
• Cost: Savings Plans, Reserved Instances, EBS optimization, snapshots, data transfer, NAT Gateway

📊 Tool Categories

Total: 76 tools - Use category filtering to load only what you need!

# Load only cost and cleanup tools (25 tools instead of 76)
export MCP_TOOL_CATEGORIES="cost,cleanup"
python -m aws_finops_mcp

📖 See TOOL_CATEGORIES.md for complete documentation

Features

76 Tools Across 14 Categories - Use category filtering to load only what you need!

🧹 Cleanup Tools (9 tools)

Find unused AWS resources to reduce costs:

• `find_unused_lambda_function