๐ค 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