Skip to content

Commit ae86eff

Browse files
authored
Merge branch 'main' into dibery/0723-mcp
2 parents e7b1485 + c8ce155 commit ae86eff

File tree

49 files changed

+2240
-508
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+2240
-508
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -330,6 +330,11 @@
330330
"redirect_url": "/azure/developer/javascript/how-to/create-static-web-app",
331331
"redirect_document_id": false
332332
},
333+
{
334+
"source_path": "articles/javascript/how-to/create-static-web-app.md",
335+
"redirect_url": "/azure/static-web-apps/",
336+
"redirect_document_id": false
337+
},
333338
{
334339
"source_path": "articles/javascript/how-to/with-web-app/static-web-app-with-swa-cli.md",
335340
"redirect_url": "/azure/static-web-apps/add-api",

CODEOWNERS

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,15 +20,20 @@
2020
/articles/python/ @bobtabor-msft
2121
/articles/go/ @bobtabor-msft
2222
/articles/cpp/ @ronniegeraghty @antkmsft
23+
/articles/rust/ @ronniegeraghty @heaths @diberry
24+
/articles/javascript/ @diberry
2325

2426
# Tools
25-
/articles/azure-cli/ @alexwolfmsft
26-
/articles/typespect/ @diberry
27+
/articles/azure-developer-cli/ @alexwolfmsft @kristenwomack
28+
/articles/typespec/ @diberry
29+
/articles/azure-mcp-server/ @ms-johnalex @sandeep-sen
30+
/articles/azure-mcp-server/tools @diberry @sandeep-sen
2731

2832
# Azure SDK authentication topics
2933
/articles/go/sdk/authentication/ @scottaddie @chlowell
30-
/articles/java/sdk/authentication/ @scottaddie @g2vinay
34+
/articles/java/sdk/authentication/ @scottaddie @g2vinay @anannya03
3135
/articles/javascript/sdk/authentication/ @scottaddie @KarishmaGhiya @minhanh-phan @maorleger
3236
/articles/python/sdk/authentication/ @scottaddie @pvaneck @xiangyan99
3337
/articles/python/sdk/authorization/ @scottaddie @pvaneck @xiangyan99
3438
/articles/cpp/sdk/authentication/ @scottaddie @antkmsft @ronniegeraghty
39+
/articles/rust/sdk/authentication/ @scottaddie @ronniegeraghty @chlowell @heaths

articles/azure-developer-cli/container-apps-workflows.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Use the `container-app-upsert` strategy when:
4141
Here's how to use the `container-app-upsert` strategy in your Bicep files:
4242

4343
```bicep
44-
module api 'br/public:avm/ptn/`azd`/container-app-upsert:0.1.1' = {
44+
module api 'br/public:avm/ptn/azd/container-app-upsert:0.1.2' = {
4545
name: 'api'
4646
params: {
4747
name: 'my-api'

articles/azure-mcp-server/TOC.yml

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,21 +16,31 @@ items:
1616
- name: Azure App Configuration
1717
href: tools/app-configuration.md
1818
- name: Azure best practices
19-
href: tools/azure-bestpractices.md
19+
href: tools/azure-best-practices.md
20+
- name: Azure Bicep schema
21+
href: tools/azure-bicep-schema.md
2022
- name: Azure Cache for Redis
2123
href: tools/azure-cache-for-redis.md
2224
- name: Azure CLI
2325
href: tools/azure-cli-extension.md
26+
- name: Azure Cosmos DB
27+
href: tools/cosmos-db.md
2428
- name: Azure Data Explorer
2529
href: tools/azure-data-explorer.md
2630
- name: Azure DB for PostgreSQL
2731
href: tools/postgresql.md
2832
- name: Azure Developer CLI
2933
href: tools/azure-developer-cli.md
30-
- name: Azure Cosmos DB
31-
href: tools/cosmos-db.md
34+
- name: Azure Foundry
35+
href: tools/azure-foundry.md
36+
- name: Azure Grafana
37+
href: tools/azure-grafana.md
3238
- name: Azure Key Vault
3339
href: tools/key-vault-key.md
40+
- name: Azure Kubernetes Service
41+
href: tools/azure-aks.md
42+
- name: Azure Load Testing
43+
href: tools/azure-load-testing.md
3444
- name: Azure MCP tool
3545
href: tools/azure-mcp-tool.md
3646
- name: Azure Monitor
@@ -41,11 +51,13 @@ items:
4151
href: tools/azure-native-isv.md
4252
- name: Azure Service Bus
4353
href: tools/service-bus.md
54+
- name: Azure SQL
55+
href: tools/azure-sql.md
4456
- name: Azure Storage
4557
href: tools/storage.md
4658
- name: Resource Group
4759
href: tools/resource-group.md
4860
- name: Subscription
4961
href: tools/subscription.md
5062
- name: Terraform best practices for Azure
51-
href: tools/azure-terraform-bestpractices.md
63+
href: tools/azure-terraform-best-practices.md

articles/azure-mcp-server/includes/tools/supported-azure-services.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,19 +13,27 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
1313
| Tool | Description |
1414
|------|--------------|
1515
| [Azure AI Search](../../tools/ai-search.md) | Manage Azure AI Search resources, including search services, indexes, and queries. |
16+
| [Azure Bicep schema](../../tools/azure-bicep-schema.md) | Retrieve Bicep schemas for Azure resources to use in Infrastructure as Code templates. |
1617
| [Azure App Configuration](../../tools/app-configuration.md) | Manage centralized application settings and feature flags. |
18+
| [Azure best practices](../../tools/azure-best-practices.md) | Get guidance on Azure Functions development, deployment, and Azure SDK usage. |
1719
| [Azure Cache for Redis](../../tools/azure-cache-for-redis.md) | Manage Azure Cache for Redis instances, Redis clusters, and access policies. |
18-
| [Azure CLI Extension](../../tools/azure-cli-extension.md) | Execute Azure CLI commands within the MCP server. |
20+
| [Azure CLI](../../tools/azure-cli-extension.md) | Execute Azure CLI commands within the MCP server. |
21+
| [Azure Cosmos DB](../../tools/cosmos-db.md) | Work with Azure Cosmos DB accounts, databases, containers, and documents. |
1922
| [Azure Data Explorer](../../tools/azure-data-explorer.md) | Work with Azure Data Explorer clusters, databases, tables, and queries. |
20-
| [Azure DB for PostgreSQL](../../tools/postgresql.md) | Manage Azure Database for PostgreSQL servers, databases, and tables. |
23+
| [Azure Database for PostgreSQL](../../tools/postgresql.md) | Manage Azure Database for PostgreSQL servers, databases, and tables. |
2124
| [Azure Developer CLI](../../tools/azure-developer-cli.md) | Execute Azure Developer CLI commands for application development and deployment. |
22-
| [Azure Cosmos DB](../../tools/cosmos-db.md) | Work with Azure Cosmos DB accounts, databases, containers, and documents. |
23-
| [Azure Key Vault](../../tools/key-vault-key.md) | Manage keys, secrets, and certificates in Azure Key Vault. |
25+
| [Azure Foundry](../../tools/azure-foundry.md) | Work with Azure AI Foundry models, deployments, and endpoints. |
26+
| [Azure Grafana](../../tools/azure-grafana.md) | List Grafana workspaces.|
27+
| [Azure Key Vault](../../tools/key-vault-key.md) | Manage keys, secrets, certificates in Azure Key Vault. |
28+
| [Azure Kubernetes Service](../../tools/azure-aks.md) | List Azure Kubernetes Service clusters. |
29+
| [Azure Load Testing](../../tools/azure-load-testing.md) | Create, run, and see load testing. |
2430
| [Azure MCP tool](../../tools/azure-mcp-tool.md) | Discover and manage available Azure MCP Server tools. |
2531
| [Azure Monitor](../../tools/monitor.md) | Query Azure Monitor logs and metrics. |
26-
| [Azure RBAC](../../tools/azure-rbac.md) | View and manage Azure role-based access control assignments. |
2732
| [Azure Native ISV](../../tools/azure-native-isv.md) | Work with Azure Native ISV services, including Datadog integration for monitoring and observability. |
33+
| [Azure RBAC](../../tools/azure-rbac.md) | View and manage Azure role-based access control assignments. |
2834
| [Azure Service Bus](../../tools/service-bus.md) | Work with Azure Service Bus messaging services. |
35+
| [Azure SQL](../../tools/azure-sql.md) | Work with Azure SQL Database servers, databases, firewall rules, and elastic pools. |
2936
| [Azure Storage](../../tools/storage.md) | List Azure Storage accounts, containers, blobs, and tables. |
3037
| [Resource Groups](../../tools/resource-group.md) | List Azure resource groups. |
3138
| [Subscription](../../tools/subscription.md) | List Azure subscriptions. |
39+
| [Terraform best practices for Azure](../../tools/azure-terraform-best-practices.md) | Get guidance on implementing Terraform for Azure resources. |
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: Azure Kubernetes Service Tools - Azure MCP Server
3+
description: Learn how to use the Azure MCP Server with Azure Kubernetes Service (AKS) to manage your Kubernetes clusters and containers.
4+
keywords: azure mcp server, azmcp, azure kubernetes service, aks, kubernetes, containers
5+
ai-usage: ai-assisted
6+
content_well_notification:
7+
- AI-contribution
8+
author: diberry
9+
ms.author: diberry
10+
ms.service: azure-mcp-server
11+
ms.topic: reference
12+
ms.date: 7/22/2025
13+
---
14+
15+
# Azure Kubernetes Service tools for the Azure MCP Server
16+
17+
The Azure MCP Server lets you manage Azure resources, including Azure Kubernetes Service (AKS) clusters, using natural language prompts. This feature enables you to quickly manage your container workloads without needing to remember complex syntax.
18+
19+
[Azure Kubernetes Service (AKS)](/azure/aks/intro-kubernetes) is a managed container orchestration service that simplifies Kubernetes deployment and management. AKS offers serverless Kubernetes, integrated CI/CD, and enterprise-grade security and governance. With AKS, you can focus on application development rather than infrastructure management.
20+
21+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
22+
23+
24+
## List clusters
25+
26+
<!--
27+
azmcp aks cluster list --subscription
28+
-->
29+
30+
Lists all Azure Kubernetes Service (AKS) clusters in the specified subscription. Use this command to quickly inventory and monitor your AKS deployments across your Azure environment.
31+
32+
Example prompts include:
33+
34+
- **List all clusters**: "Show me all my AKS clusters in my subscription"
35+
- **View cluster inventory**: "Can you list the Kubernetes clusters in resource group 'container-rg' for subscription 'dev-123'?"
36+
- **Check cluster status**: "AKS clusters... dev environment... quick overview"
37+
- **Cluster overview**: "I need a complete inventory of all our Kubernetes deployments across our enterprise subscription with their node counts and versions."
38+
- **Find clusters**: "List clusters in the East US region only"
39+
- **Monitor deployments**: "What's the status of our production AKS clusters? Are they all running properly?"
40+
41+
42+
| Parameter | Required or optional | Description |
43+
|-----------|-------------|-------------|
44+
| Subscription | Required | The ID or name of your Azure subscription containing the AKS clusters. |
45+
46+
47+
## Related content
48+
49+
- [What are the Azure MCP Server tools?](index.md)
50+
- [Get started using Azure MCP Server](../get-started.md)
51+
- [Azure Kubernetes Service documentation](/azure/aks/)
52+
- [Kubernetes best practices](/azure/aks/best-practices)
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Azure best practices tools - Azure MCP Server
3+
description: Use the Azure best practices tools in Azure MCP Server to get guidance on Azure Functions development, deployment, and Azure SDK usage.
4+
keywords: azure mcp server, azmcp, best practices
5+
ms.service: azure-mcp-server
6+
content_well_notification:
7+
- AI-contribution
8+
ai-usage: ai-assisted
9+
ms.topic: reference
10+
ms.date: 07/22/2025
11+
author: diberry
12+
ms.author: diberry
13+
---
14+
15+
# Azure best practices tools
16+
17+
This article describes the best practices tools available in Azure MCP Server that provide guidance on Azure service usage, development, and deployment.
18+
19+
Azure best practices tools offer recommendations for Azure Functions development, deployment strategies, and Azure SDK implementation patterns to help you build robust, secure, and efficient Azure applications.
20+
21+
22+
## Azure Functions
23+
24+
## Get code generation best practices
25+
26+
<!-- azmcp bestpractices azurefunctions get-code-generation -->
27+
28+
Returns best practices for [Azure Functions](/azure/azure-functions/) code generation. Use this tool to get guidance on writing efficient and maintainable Azure Functions code.
29+
30+
Example prompts include:
31+
32+
- **General best practices**: "What are the best practices for Azure Functions code generation?"
33+
- **Show recommendations**: "Show me code generation best practices for Azure Functions."
34+
- **Development guidance**: "I need guidance on writing Azure Functions code, what should I follow?"
35+
- **Recommended patterns**: "What are the recommended patterns for Azure Functions development?"
36+
- **Efficient coding**: "Help me understand how to write efficient Azure Functions code."
37+
38+
### Get deployment best practices
39+
40+
<!-- azmcp bestpractices azurefunctions get-deployment -->
41+
42+
Returns best practices for Azure Functions deployment. Use this tool to get guidance on deploying Azure Functions applications efficiently and securely.
43+
44+
Example prompts include:
45+
46+
- **Deployment best practices**: "What are the best practices for deploying Azure Functions?"
47+
- **CI/CD setup**: "How should I set up CI/CD for my Azure Functions app?"
48+
- **Deployment recommendations**: "Show me deployment recommendations for Azure Functions."
49+
- **Production deployment**: "What's the best way to deploy Azure Functions to production?"
50+
- **Secure pipeline**: "I need guidance on setting up a secure deployment pipeline for Azure Functions."
51+
52+
53+
## Azure SDK
54+
55+
## Get best practices
56+
57+
<!-- azmcp bestpractices general get -->
58+
59+
Returns best practices for secure, production-grade Azure SDK usage. Use this tool to get guidance on implementing Azure services in your applications.
60+
61+
Example prompts include:
62+
63+
- **General best practices**: "What are the best practices for using Azure SDKs?"
64+
- **Implementation guidance**: "Show me guidance on implementing Azure services in my application"
65+
- **Authentication handling**: "How should I handle authentication with Azure SDKs?"
66+
- **Connection management**: "What's the recommended way to manage connections with Azure services?"
67+
- **Secure implementation**: "I need help implementing Azure services securely in my application"
68+
69+
70+
## Related resources
71+
72+
- [Azure Functions documentation](/azure/azure-functions/)
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: Azure Bicep Schema Tools - Azure MCP Server
3+
description: Learn how to use the Azure MCP Server with Azure Bicep Schema to retrieve the latest API versions and properties for Azure resources in Bicep templates.
4+
keywords: azure mcp server, azmcp, azure bicep, bicep schema, arm templates, infrastructure as code
5+
ms.service: azure-mcp-server
6+
ms.topic: reference
7+
ms.date: 07/22/2025
8+
content_well_notification:
9+
- AI-contribution
10+
ai-usage: ai-assisted
11+
---
12+
13+
# Azure Bicep Schema tools for the Azure MCP Server
14+
15+
The Azure MCP Server enables you to manage Azure resources, including Azure Bicep schemas, with natural language prompts. With this capability, you can quickly retrieve the latest API versions and property definitions for your Infrastructure as Code templates without needing to remember complex syntax.
16+
17+
[Azure Bicep](/azure/azure-resource-manager/bicep/) is a domain-specific language (DSL) that simplifies the authoring experience for Azure Resource Manager templates. Bicep offers concise syntax, reliable type safety, and support for all resource types and API versions.
18+
19+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
20+
21+
## Get Bicep Resource Schema
22+
23+
<!-- azmcp bicepschema get -->
24+
25+
Gets the Bicep schema for the most recent apiVersion of an Azure resource. This operation helps you ensure your Bicep templates use the correct properties and values when defining Azure resources.
26+
27+
Example prompts include:
28+
29+
- **Get storage account schema**: "Get me the Bicep schema for Microsoft.Storage/storageAccounts"
30+
- **Find service properties**: "How can I use Bicep to create an Azure OpenAI service?"
31+
- **Check API version**: "What's the latest apiVersion for Microsoft.KeyVault/vaults?"
32+
- **Need schema help**: "I'm creating a Bicep template for Microsoft.Cognitive/accounts"
33+
- **Request schema guidance**: "Show me the properties for Microsoft.Web/sites"
34+
35+
| Parameter | Required or optional | Description |
36+
|-----------|-------------|-------------|
37+
| Resource type | Required | The Azure resource type in format '{ResourceProvider}/{ResourceType}' (e.g., 'Microsoft.Storage/storageAccounts', 'Microsoft.Compute/virtualMachines') |
38+
39+
## Related content
40+
41+
- [What are the Azure MCP Server tools?](index.md)
42+
- [Get started using Azure MCP Server](../get-started.md)
43+
- [Azure Bicep documentation](/azure/azure-resource-manager/bicep/)
44+
- [Azure Resource Manager template reference](/azure/templates/)

0 commit comments

Comments
 (0)