Azure FinOps Elite

License: MIT Python 3.10+ FastMCP

Production-grade Azure FinOps MCP Server for Enterprise Cost Optimization

💰 Proven Results: Organizations using Azure FinOps Elite achieve an average 20% reduction in cloud costs within the first 90 days.

---

⭐ Star This Repository

If you find Azure FinOps Elite valuable, please star this repository to help others discover it!

💖 Support This Project

Azure FinOps Elite is free and open-source. If it saves you money or time, please consider:

• ⭐ Starring this repository
• 💰 Sponsoring via GitHub Sponsors
• 🐛 Reporting bugs and suggesting features
• 📝 Contributing code or documentation

Your support helps maintain and improve this project!

---

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/mazhar480/azure-finops-elite.git
cd azure-finops-elite

# Install dependencies
pip install -r requirements.txt

# Configure credentials
cp .env.example .env
# Edit .env with your Azure credentials

Web Dashboard (Recommended)

# Start the web dashboard
python web_dashboard.py

# Open browser to http://localhost:5000

MCP Server (For AI Assistants)

# Start the MCP server
python server.py

---

✨ Features

🔍 Enterprise Anomaly Detection

Detect daily spend spikes across multiple subscriptions by comparing actual costs vs. 7-day historical averages.

🏢 CSP Multi-Tenant Audit

Audit delegated sub-tenants to identify unattached disks and idle public IPs with immediate ROI.

💰 Pre-Deployment Budget Validation

Validate ARM/Bicep templates against Azure Price Sheet API before execution.

🛡️ Governance & Compliance Advisor

Azure Advisor integration with custom risk scoring based on NIA Qatar and ISO 27001 frameworks.

📊 Executive Summary Generator

Generate Markdown-formatted FinOps ROI reports for non-technical stakeholders.

⚖️ Compliance Overlay

Automatically flag cost-saving recommendations that may impact ISO 27001 or NIA Qatar controls.

🚀 One-Click Setup

Generate ready-to-use Azure Custom Role JSON with least-privilege read-only access.

---

🌐 Web Dashboard

Beautiful GUI for all FinOps tools:

• Configuration Management - Set Azure credentials via web interface
• Real-time Analysis - Run tools and see results instantly
• Report Generation - Create and download executive summaries
• Report History - Browse and manage all generated reports

---

🔐 Enterprise Security

• ✅ Zero Trust Architecture
• ✅ Certificate-based Authentication
• ✅ ISO 27001 Compliant
• ✅ NIA Qatar Framework Support
• ✅ Least-Privilege RBAC
• ✅ Comprehensive Audit Logging

---

📚 Documentation

• Quick Start - Get started in 5 minutes
• Windows Testing Guide - Complete Windows setup
• Web Dashboard Guide - Using the GUI
• Security Guide - Authentication & compliance
• Customer Experience - Advanced features
• Agent Guide - FinOps automation workflows

---

🎯 Use Cases

For Enterprises

• Monitor cloud costs across multiple subscriptions
• Detect anomalies before they impact budgets
• Ensure compliance with ISO 27001 and regional frameworks
• Generate executive reports for stakeholders

For CSPs (Cloud Service Providers)

• Audit customer tenants for cost optimization
• Demonstrate value through savings reports
• Automate resource cleanup recommendations
• Maintain compliance across customer environments

For DevOps Teams

• Validate infrastructure costs in CI/CD pipelines
• Prevent budget overruns before deployment
• Integrate cost governance into workflows
• Track and optimize resource usage

---

🏗️ Architecture

azure-finops-elite/
├── server.py                    # FastMCP server (for AI assistants)
├── web_dashboard.py             # Flask web dashboard (for humans)
├── auth.py                      # Certificate + Managed Identity auth
├── azure_clients.py             # Azure SDK client factory
├── tools/
│   ├── anomaly_detector.py     # Spend spike detection
│   ├── csp_auditor.py          # Multi-tenant resource audit
│   ├── budget_validator.py     # ARM/Bicep cost validation
│   ├── governance_advisor.py   # Risk-scored recommendations
│   ├── executive_summary.py    # Executive ROI reports
│   └── compliance_overlay.py   # Compliance impact checker
├── utils/
│   ├── error_handling.py       # Retry logic & rate limiting
│   ├── logging_config.py       # Structured logging
│   └── pricing.py              # Cost estimation
└── templates/
    └── dashboard.html          # Web dashboard UI

---

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Setup

# Install dev dependencies
pip install -r requirements.txt
pip install pytest black isort mypy

# Run tests
pytest

# Format code
black .
isort .

---

📊 Metrics & KPIs

Track your FinOps success:

• Cost Optimization: Anomalies detected, excess spend prevented
• Resource Efficiency: Unattached resources identified and removed
• Compliance: Risk score improvements, control coverage
• ROI: Total savings vs. tool investment

---

🌟 Success Stories

"Azure FinOps Elite helped us identify $50K/month in wasteful spending within the first week. The executive summaries made it easy to get buy-in from leadership." — Enterprise Customer

"As a CSP, this tool helps us demonstrate value to our customers. The compliance overlay ensures we never compromise security for cost savings." — Cloud Service Provider

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

💬 Support

• 📖 Documentation: Check the docs
• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Open an issue
• 💰 Sponsorship: GitHub Sponsors

---

🙏 Acknowledgments

Built with:

• FastMCP - Model Context Protocol framework
• Azure SDK for Python - Azure API integration
• Flask - Web dashboard framework

---

⚡ Quick Links

• Installation
• Web Dashboard
• Documentation
• Contributing
• Support This Project

---

Made with ❤️ for the FinOps community

⭐ Star this repo | 💰 Sponsor | 📖 Docs