🤖 AWS FinOps MCP Server
Servidor FinOps orientado a IA construido con Spring Boot y AWS SDK v2. El proyecto expone herramientas tipo MCP (Model Context Protocol) para consultar costes AWS, detectar anomalías y generar recomendaciones de optimización cloud.
🎯 Objetivo
Centralizar capacidades FinOps reutilizables mediante herramientas desacopladas que puedan ser consumidas por:
- 🤖 AI Agents
- 📊 Dashboards internos
- ☁️ Plataformas cloud
- 🛠️ Herramientas DevOps
- 📁 Sistemas de reporting
El sistema permite:
- Obtener costes AWS por servicio
- Detectar anomalías de gasto
- Generar recomendaciones de rightsizing
- Exportar reportes CSV
- Explicar hallazgos FinOps en lenguaje natural
- Trabajar con múltiples cuentas AWS usando AssumeRole
🏗️ Arquitectura
El proyecto sigue una arquitectura modular basada en herramientas MCP.
controller→ endpoints RESTdispatcher→ enrutado dinámico de toolstools→ contratos MCPimpl→ implementación de herramientas FinOpsservice→ lógica de negocioaws→ integración AWS SDK v2account→ gestión multi-accountcsv→ exportación de reportes
⚙️ Tecnologías
- Java 21
- Spring Boot 3.3.5
- AWS SDK v2
- Maven
- JUnit 5
- Lombok
- Apache Commons CSV
- Docker
🧠 Principios SOLID aplicados
S - Single Responsibility
- Cada Tool tiene una responsabilidad concreta
ToolDispatcherúnicamente enruta herramientas- Los adapters AWS encapsulan integración cloud
O - Open/Closed
- Nuevas herramientas MCP pueden añadirse sin modificar lógica existente
L - Liskov Substitution
- Los servicios AWS pueden sustituirse por mocks o implementaciones alternativas
I - Interface Segregation
FinOpsTooldefine contratos simples y específicos
D - Dependency Inversion
- La lógica de negocio depende de interfaces y servicios desacoplados
🧩 Flujo completo
Cliente / AI Agent ↓ McpController ↓ ToolDispatcher ↓ ToolRegistry ↓ FinOpsTool ↓ AWS Adapter ↓ AWS SDK v2 ↓ AWS APIs
🛠️ Herramientas disponibles
📊 get_top_costs_by_service
Obtiene los servicios AWS con mayor coste.
Parámetros
🚨 detect_cost_anomalies
Detecta anomalías y picos de gasto cloud.
Parámetros
💡 get_rightsizing_recommendations
Genera recomendaciones de optimización EC2.
🧠 explain_findings
Resume automáticamente hallazgos FinOps combinando anomalías y recomendaciones.
☁️ Integración AWS
El proyecto utiliza:
- AWS Cost Explorer
- AWS EC2
- AWS CloudWatch
- AWS STS
🔐 Multi-account AWS
Soporta múltiples cuentas AWS usando AssumeRole.
Ejemplo application.yml
finops:
accounts:
- account-id: "111111111111"
alias: "prod"
role-arn: "arn:aws:iam::111111111111:role/FinOpsReadOnlyRole"
region: "eu-west-1"
- account-id: "222222222222"
alias: "staging"
role-arn: "arn:aws:iam::222222222222:role/FinOpsReadOnlyRole"
region: "eu-west-1"
📁 Exportación CSV
Los reportes pueden exportarse automáticamente a CSV mediante:
CsvExporter
Ejemplo generado:
output/cost-report.csv
🟢 Cómo ejecutar
1️⃣ Clonar proyecto
git clone <repo-url>
cd AWS-FinOps-MCP-Server
2️⃣ Configurar credenciales AWS
aws configure
3️⃣ Compilar proyecto
mvn clean install
4️⃣ Ejecutar aplicación
mvn spring-boot:run
🚀 Endpoint principal
POST /mcp/tools/cost/report
📬 Ejemplo petición
{
"tool": "get_top_costs_by_service",
"arguments": {
"days": 30,
"limit": 5
}
}
🧪 Testing
El proyecto incluye:
- Unit Tests
- Service Tests
- Tool Tests
- Dispatcher Tests
Ejecutar tests:
mvn test
🐳 Docker
Build imagen
docker build -t aws-finops-mcp .
Ejecutar contenedor
docker run -p 8080:8080 aws-finops-mcp
📦 Build del JAR
mvn clean package
El artefacto generado:
target/aws-finops-mcp-1.0.0.jar
📊 Casos de uso
- AI Agents FinOps
- Dashboards de costes cloud
- Monitorización AWS
- Rightsizing automatizado
- Reporting financiero cloud
- Gobierno multi-account
🚀 Futuras mejoras
- MCP protocol nativo
- Integración OpenAI / Bedrock
- Savings Plans Analyzer
- Kubernetes cost allocation
- Alertas Slack / Teams
- Dashboards Grafana
🎯 Conclusión
Este proyecto demuestra:
- Arquitectura modular escalable
- Integración avanzada con AWS SDK v2
- Diseño orientado a herramientas IA
- Buenas prácticas SOLID
- Multi-account AWS
- Exportación automatizada de reportes
- Contenedorización con Docker
- Capacidades FinOps reales