Add compute VM and VMSS create/update commands with smart workload-based defaults

.gitignore

@@ -29,3 +29,6 @@ eng/tools/ToolDescriptionEvaluator/prompts.json
 eng/tools/ToolDescriptionEvaluator/results.md
 eng/tools/ToolDescriptionEvaluator/tools.json
 deploy-log.txt
+
+# VM-specific documentation (internal/personal notes)
+docs/vm-docs/

core/Microsoft.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json

@@ -2239,6 +2239,74 @@
         "aks_nodepool_get"
       ]
     },
+    {
+      "name": "create_azure_compute_resources",
+      "description": "Create Azure compute resources including Virtual Machines (VMs) and Virtual Machine Scale Sets (VMSS). Create VMs with smart workload-based defaults (development, web, database, compute, memory, gpu, general). Supports Linux and Windows with SSH key or password authentication. Create VMSS for scalable workloads with configurable instance count and upgrade policies.",
+      "toolMetadata": {
+        "destructive": {
+          "value": true,
+          "description": "This tool creates new resources which may incur costs."
+        },
+        "idempotent": {
+          "value": false,
+          "description": "Running this operation multiple times may create duplicate resources."
+        },
+        "openWorld": {
+          "value": false,
+          "description": "This tool's domain of interaction is closed and well-defined, limited to a specific set of entities."
+        },
+        "readOnly": {
+          "value": false,
+          "description": "This tool creates new Azure resources."
+        },
+        "secret": {
+          "value": true,
+          "description": "This tool handles sensitive authentication information like passwords and SSH keys."
+        },
+        "localRequired": {
+          "value": false,
+          "description": "This tool is available in both local and remote server modes."
+        }
+      },
+      "mappedToolList": [
+        "compute_vm_create",
+        "compute_vmss_create"
+      ]
+    },
+    {
+      "name": "update_azure_compute_resources",
+      "description": "Update Azure compute resources including Virtual Machines (VMs) and Virtual Machine Scale Sets (VMSS). Modify VM properties like size, tags, license type, boot diagnostics, and user data. Update VMSS capacity, upgrade policy, overprovision settings, auto OS upgrade, and scale-in policies. Uses PATCH semantics - only specified properties are updated.",
+      "toolMetadata": {
+        "destructive": {
+          "value": true,
+          "description": "This tool modifies existing resources."
+        },
+        "idempotent": {
+          "value": true,
+          "description": "Running this operation multiple times with the same arguments produces the same result."
+        },
+        "openWorld": {
+          "value": false,
+          "description": "This tool's domain of interaction is closed and well-defined, limited to a specific set of entities."
+        },
+        "readOnly": {
+          "value": false,
+          "description": "This tool modifies Azure resources."
+        },
+        "secret": {
+          "value": false,
+          "description": "This tool does not handle sensitive or secret information."
+        },
+        "localRequired": {
+          "value": false,
+          "description": "This tool is available in both local and remote server modes."
+        }
+      },
+      "mappedToolList": [
+        "compute_vm_update",
+        "compute_vmss_update"
+      ]
+    },
     {
       "name": "get_azure_virtual_desktop_details",
       "description": "Get details about Azure Virtual Desktop resources. List host pools in subscriptions or resource groups. Retrieve session hosts (virtual machines) within host pools including their status, availability, and configuration. View active user sessions on session hosts with details such as user principal name, session state, application type, and creation time.",

eng/scripts/Deploy-TestResources.ps1

@@ -4,6 +4,7 @@ param(
     [string]$SubscriptionId,
     [string]$ResourceGroupName,
     [string]$BaseName,
+    [string]$Location,
     [int]$DeleteAfterHours = 12,
     [switch]$Unique,
     [switch]$Parallel,
@@ -69,6 +70,7 @@ function Deploy-TestResources
         [string]$SubscriptionName,
         [string]$ResourceGroupName,
         [string]$BaseName,
+        [string]$Location,
         [int]$DeleteAfterHours,
         [string]$TestResourcesDirectory,
         [switch]$AsJob
@@ -81,29 +83,32 @@ Deploying$($AsJob ? ' in background job' : ''):
     SubscriptionName: '$SubscriptionName'
     ResourceGroupName: '$ResourceGroupName'
     BaseName: '$BaseName'
+    Location: '$Location'
     DeleteAfterHours: $DeleteAfterHours
     TestResourcesDirectory: '$TestResourcesDirectory'`n
 "@ -ForegroundColor Yellow
 
     if($AsJob) {
         Start-Job -ScriptBlock {
-            param($RepoRoot, $SubscriptionId, $ResourceGroupName, $BaseName, $testResourcesDirectory, $DeleteAfterHours, $UseHttpTransport)
+            param($RepoRoot, $SubscriptionId, $ResourceGroupName, $BaseName, $Location, $testResourcesDirectory, $DeleteAfterHours, $UseHttpTransport)
 
             & "$RepoRoot/eng/common/TestResources/New-TestResources.ps1" `
                 -SubscriptionId $SubscriptionId `
                 -ResourceGroupName $ResourceGroupName `
                 -BaseName $BaseName `
+                -Location $Location `
                 -TestResourcesDirectory $testResourcesDirectory `
                 -DeleteAfterHours $DeleteAfterHours `
                 -UseHttpTransport:$UseHttpTransport `
                 -Force
 
-        } -ArgumentList $RepoRoot, $SubscriptionId, $ResourceGroupName, $BaseName, $TestResourcesDirectory, $DeleteAfterHours, $UseHttpTransport
+        } -ArgumentList $RepoRoot, $SubscriptionId, $ResourceGroupName, $BaseName, $Location, $TestResourcesDirectory, $DeleteAfterHours, $UseHttpTransport
     } else {
         & "$RepoRoot/eng/common/TestResources/New-TestResources.ps1" `
             -SubscriptionId $SubscriptionId `
             -ResourceGroupName $ResourceGroupName `
             -BaseName $BaseName `
+            -Location $Location `
             -TestResourcesDirectory $testResourcesDirectory `
             -DeleteAfterHours $DeleteAfterHours `
             -UseHttpTransport:$UseHttpTransport `
@@ -129,6 +134,7 @@ $jobInputs = $testablePaths | ForEach-Object {
         SubscriptionName = $subscriptionName
         ResourceGroupName = $ResourceGroupName ? $ResourceGroupName : "$accountName-mcp$($suffix)"
         BaseName = $BaseName ? $BaseName : "mcp$($suffix)"
+        Location = $Location
         DeleteAfterHours = $DeleteAfterHours
         TestResourcesDirectory = Resolve-Path -Path "$RepoRoot/$_/tests"
     }

servers/Azure.Mcp.Server/README.md

@@ -913,6 +913,12 @@ Check out the remote hosting [azd templates](https://github.com/microsoft/mcp/bl
 * "Get virtual machine 'my-vm' with instance view including power state and runtime status"
 * "Show me the power state and provisioning status of VM 'my-vm'"
 * "What is the current status of my virtual machine 'my-vm'?"
+* "Create a new VM named 'my-vm' in resource group 'my-rg' for web workloads"
+* "Create a Linux VM with Ubuntu 22.04 and SSH key authentication"
+* "Create a development VM with Standard_B2s size in East US"
+* "Update VM 'my-vm' tags to environment=production"
+* "Create a VMSS named 'my-vmss' with 3 instances for web workloads"
+* "Update VMSS 'my-vmss' capacity to 5 instances"
 
 ### �📦 Azure Container Apps
 

servers/Azure.Mcp.Server/changelog-entries/1770833341707.yaml

@@ -0,0 +1,3 @@
+changes:
+  - section: "Features Added"
+    description: "Added Azure Compute tools for Virtual Machines (VMs) and Virtual Machine Scale Sets (VMSS). Includes VM get (list, details, instance view), VMSS get (list, details, VM instances), VM create/update with smart workload-based defaults, and VMSS create/update operations"