Skip to content

Commit fb7f09b

Browse files
Stacyrch140Stacyrch140
authored
Merge pull request #7566 from diberry/diberry/0722-mcp
MCP best practices -
2 parents 81d67e0 + 1d61b6d commit fb7f09b

File tree

5 files changed

+153
-3
lines changed

5 files changed

+153
-3
lines changed

‎articles/azure-mcp-server/TOC.yml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ items:
1515
href: tools/ai-search.md
1616
- name: Azure App Configuration
1717
href: tools/app-configuration.md
18+
- name: Azure best practices
19+
href: tools/azure-best-practices.md
1820
- name: Azure Bicep schema
1921
href: tools/azure-bicep-schema.md
2022
- name: Azure Cache for Redis
@@ -52,4 +54,6 @@ items:
5254
- name: Resource Group
5355
href: tools/resource-group.md
5456
- name: Subscription
55-
href: tools/subscription.md
57+
href: tools/subscription.md
58+
- name: Terraform best practices for Azure
59+
href: tools/azure-terraform-best-practices.md

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

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
ms.author: diberry
44
ms.service: azure-mcp-server
55
ms.topic: include
6-
ms.date: 07/01/2025
6+
ms.date: 07/22/2025
77
---
88

99
## Available tools
@@ -15,6 +15,7 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
1515
| [Azure AI Search](../../tools/ai-search.md) | Manage Azure AI Search resources, including search services, indexes, and queries. |
1616
| [Azure Bicep schema](../../tools/azure-bicep-schema.md) | Retrieve Bicep schemas for Azure resources to use in Infrastructure as Code templates. |
1717
| [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. |
1819
| [Azure Cache for Redis](../../tools/azure-cache-for-redis.md) | Manage Azure Cache for Redis instances, Redis clusters, and access policies. |
1920
| [Azure CLI Extension](../../tools/azure-cli-extension.md) | Execute Azure CLI commands within the MCP server. |
2021
| [Azure Cosmos DB](../../tools/cosmos-db.md) | Work with Azure Cosmos DB accounts, databases, containers, and documents. |
@@ -32,4 +33,5 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
3233
| [Azure SQL](../../tools/azure-sql.md) | Work with Azure SQL Database servers, databases, firewall rules, and elastic pools. |
3334
| [Azure Storage](../../tools/storage.md) | List Azure Storage accounts, containers, blobs, and tables. |
3435
| [Resource Groups](../../tools/resource-group.md) | List Azure resource groups. |
35-
| [Subscription](../../tools/subscription.md) | List Azure subscriptions. |
36+
| [Subscription](../../tools/subscription.md) | List Azure subscriptions. |
37+
| [Terraform best practices for Azure](../../tools/azure-terraform-best-practices.md) | Get guidance on implementing Terraform for Azure resources. |

‎articles/azure-mcp-server/tools/azure-best-practices.md‎

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/)

‎articles/azure-mcp-server/tools/azure-terraform-best-practices.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
title: Terraform best practices for Azure - Azure MCP Server
3+
description: Use the Azure Terraform best practices tool in Azure MCP Server to get guidance on implementing Terraform for Azure resources.
4+
keywords: azure mcp server, azmcp, terraform, 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+
# Terraform best practices for Azure tools
16+
17+
This article describes the Terraform best practices for Azure tool available in Azure MCP Server. The tool provides guidance for implementing Infrastructure as Code (IaC) with Terraform in Azure environments.
18+
19+
Terraform best practices for Azure helps you implement secure, scalable, and maintainable infrastructure configurations by using recommended patterns and practices from Microsoft.
20+
21+
## Get best practices
22+
23+
<!-- azmcp azureterraformbestpractices get -->
24+
25+
Returns best practices for implementing Terraform with Azure. Use this tool to get guidance on creating secure, scalable, and maintainable infrastructure as code for Azure resources.
26+
27+
Example prompts include:
28+
29+
- **General best practices**: "What are the best practices for using Terraform with Azure?"
30+
- **Implementation guidance**: "Show me guidance for implementing Azure resources with Terraform"
31+
- **Module structure**: "How should I structure my Terraform modules for Azure?"
32+
- **State management**: "What are the recommended patterns for managing state files in Azure Terraform projects?"
33+
- **Secure infrastructure**: "I need help implementing secure Azure infrastructure using Terraform"
34+
35+
36+
## Related resources
37+
38+
- [Terraform on Azure documentation](/azure/developer/terraform/)
39+
- [Azure Architecture Center - Best practices in cloud applications](/azure/architecture/best-practices/)

‎articles/azure-mcp-server/tools/tools.json‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,37 @@
11
{
2+
"azure-azureterraformbestpractices": {
3+
"root": "azmcp azureterraformbestpractices",
4+
"tools": [
5+
{
6+
"name": "get",
7+
"description": "Execute the get operation.",
8+
"params": []
9+
}
10+
]
11+
},
12+
"azure-bestpractices": {
13+
"root": "azmcp bestpractices",
14+
"tools": [
15+
{
16+
"name": "azurefunctions get-code-generation",
17+
"description": "Execute the azurefunctions get-code-generation operation.",
18+
"params": [],
19+
"status": "new"
20+
},
21+
{
22+
"name": "azurefunctions get-deployment",
23+
"description": "Execute the azurefunctions get-deployment operation.",
24+
"params": [],
25+
"status": "new"
26+
},
27+
{
28+
"name": "general get",
29+
"description": "Get general.",
30+
"params": []
31+
}
32+
]
33+
},
34+
235
"azure-app-configuration": {
336
"root": "azmcp appconfig",
437
"tools": [

0 commit comments

Comments
 (0)