the-funky-1/azure.server.mcp

Azure Developer MCP Server

A production-ready Model Context Protocol (MCP) server that simplifies Azure deployment and management for developers. Deploy your applications to Azure with minimal configuration using intelligent project analysis and smart service provisioning.

⚡ Quick Start

Prerequisites

• Python 3.9+
• Azure CLI installed and authenticated (az login)
• An active Azure subscription

Installation

# Clone and install
git clone <repository-url>
cd azure.server
pip install -e .

# Verify installation
azure-mcp --version

First Deployment

# Navigate to your project
cd my-web-app

# Deploy with minimal configuration
azure-mcp deploy --name my-app --environment dev

That's it! The server will:

• 🔍 Analyze your project structure
• 🏗️ Provision appropriate Azure services
• 📦 Deploy your application
• 💰 Optimize for cost efficiency

🎯 Core Features

Three Powerful Tools

1. azure_deploy - Intelligent deployment with project analysis
2. azure_pipeline - CI/CD pipeline generation and management
3. azure_manage - Resource management and monitoring

Smart Capabilities

• Auto-Detection: Recognizes 15+ project types (React, Node.js, Python, .NET, etc.)
• Cost Optimization: Chooses right-sized resources for each environment
• Infrastructure as Code: Generates Bicep templates automatically
• Environment Management: Seamless dev/staging/prod workflows
• Zero-Config Auth: Uses Azure CLI credential chain

🚀 Usage Examples

Deploy a React App

# MCP Tool Call
{
    "tool": "azure_deploy",
    "arguments": {
        "project_path": "./my-react-app",
        "deployment_name": "react-portfolio",
        "environment": "production",
        "config": {
            "custom_domain": "portfolio.example.com",
            "enable_cdn": true
        }
    }
}

Result: Static Web App with CDN, custom domain, and SSL certificate

Deploy a Full-Stack Application

# MCP Tool Call
{
    "tool": "azure_deploy",
    "arguments": {
        "project_path": "./fullstack-app",
        "deployment_name": "my-saas",
        "environment": "production",
        "config": {
            "database": "postgresql",
            "enable_redis": true,
            "scaling": "auto"
        }
    }
}

Result: App Service + PostgreSQL + Redis + Application Insights

Create CI/CD Pipeline

# MCP Tool Call
{
    "tool": "azure_pipeline",
    "arguments": {
        "action": "create",
        "project_path": "./api-service",
        "pipeline_name": "api-cicd",
        "config": {
            "triggers": ["main", "develop"],
            "environments": ["staging", "production"],
            "tests": true,
            "security_scan": true
        }
    }
}

Result: Azure DevOps pipeline with testing, security scanning, and multi-environment deployment

Monitor and Scale

# MCP Tool Call
{
    "tool": "azure_manage",
    "arguments": {
        "action": "monitor",
        "resource_group": "my-saas-prod",
        "metrics": ["performance", "costs", "errors"]
    }
}

Result: Performance dashboard with cost analysis and scaling recommendations

🏗️ Supported Project Types

🔧 Configuration

Environment Configuration

Create azure-mcp.toml in your project root:

[project]
name = "my-application"
type = "auto"  # or specific: "react", "nodejs", "python", etc.

[environments.dev]
region = "eastus"
sku = "Free"
database = false
redis = false

[environments.staging]
region = "eastus"
sku = "Standard"
database = "sqlite"
redis = false

[environments.production]
region = "eastus"
sku = "Premium"
database = "postgresql"
redis = true
cdn = true
monitoring = true

[azure]
subscription_id = "your-subscription-id"  # optional
resource_group_prefix = "myapp"

Global Configuration

Configure default settings:

# Set default subscription
azure-mcp config set subscription "your-subscription-id"

# Set default region
azure-mcp config set region "eastus"

# Set cost optimization level
azure-mcp config set cost-optimization "aggressive"

🛡️ Security & Best Practices

Authentication

• Uses Azure CLI credential chain (no keys to manage)
• Supports Managed Identity in Azure environments
• Role-based access control (RBAC) integration

Security Features

• Key Vault integration for secrets management
• TLS/SSL certificates automatically provisioned
• Network security groups with minimal required access
• Container scanning for Docker deployments

Cost Optimization

• Dev: Free tiers and minimal resources
• Staging: Shared resources with basic monitoring
• Production: Auto-scaling with cost alerts

📊 Cost Estimation

Before deployment, get cost estimates:

# MCP Tool Call
{
    "tool": "azure_deploy",
    "arguments": {
        "project_path": "./my-app",
        "deployment_name": "cost-check",
        "environment": "production",
        "config": {
            "estimate_only": true
        }
    }
}

Sample Output:

💰 Monthly Cost Estimate (Production):
├── App Service (Standard S1): $73/month
├── PostgreSQL (Basic): $25/month
├── Redis Cache (Basic): $16/month
├── Application Insights: $5/month
└── Total: ~$119/month

🔄 Infrastructure as Code

All deployments generate Bicep templates for reproducibility:

deployments/
├── main.bicep              # Main infrastructure template
├── parameters.dev.json     # Dev environment parameters
├── parameters.staging.json # Staging parameters
├── parameters.prod.json    # Production parameters
└── modules/               # Reusable Bicep modules
    ├── app-service.bicep
    ├── database.bicep
    └── monitoring.bicep

Deploy using generated templates:

# Deploy to production
az deployment group create \
  --resource-group myapp-prod \
  --template-file deployments/main.bicep \
  --parameters @deployments/parameters.prod.json

🚨 Troubleshooting

Common Issues

Authentication Error

# Re-authenticate with Azure CLI
az login
az account set --subscription "your-subscription-id"

Deployment Fails

# Check deployment logs
azure-mcp logs --deployment-name my-app --environment prod

# Validate Bicep template
az bicep validate --file deployments/main.bicep

Cost Alerts

# Check current costs
azure-mcp manage --action costs --resource-group myapp-prod

# Set up cost alerts
azure-mcp manage --action cost-alert --budget 100 --threshold 80

🤝 Contributing

We welcome contributions! Please see for details.

📄 License

MIT License - see for details.

🆘 Support

• 📖 Documentation
• 🐛 Issues
• 💬 Discussions