Azure Bicep MCP Integration Setup

Azure二头肌MCP服务器（实验性）与其他AI服务的集成

本指南解释了如何在本地为Claude Desktop和Code、OpenAI Codex CLI以及LMStudio运行Azure二头肌MCP服务器，您可以在其中与各种模型一起使用它。

参见克劳德代码示例：

Claude Code Calling Bicep MCP Server

概述

二头肌MCP（模型上下文协议）服务器为AI代理提供了帮助生成高质量二头肌代码的工具。它公开了以下工具：

• list_az_resource_types_for_provider -列出特定提供商（例如Microsoft.Storage）的所有Azure资源类型
• get_az_resource_type_schema -获取特定Azure资源类型和API版本的架构
• get_bicep_best_practices -返回二头肌编码最佳实践和指南
• decompile_arm_parameters_file -将ARM模板参数JSON文件转换为二头肌参数格式（.digmaparam）。
• decompile_arm_template_file -将ARM模板JSON文件转换为二头肌语法（.dipum）。
• format_bicep_file -对二头肌文件应用一致的格式（缩进、间距、换行）。
• get_bicep_file_diagnostics -分析二头肌文件并返回所有编译诊断。
• get_file_references -分析二头肌文件并返回所有引用文件的列表，包括模块、参数文件和其他依赖项。
• get_deployment_snapshot -从.digmaparam文件创建快照，以预览资源并比较二头肌实现。
• list_avm_metadata -列出所有Azure验证模块（AVM）的元数据

查看 二头肌MCP服务器文档 了解更多信息。

先决条件

• .NET 10.0 SDK 或更高版本（用.NET 10.0测试）
• Git（用于克隆存储库）

选项

有两种方法可以获取二头肌MCP服务器DLL：

• 选项1：使用dnx运行Azure二头肌MCP NuGet包（推荐方法）
• 选项2：从源代码构建（更多控制，更容易更新）
• 选项3：从VS代码扩展中提取

选项1：使用dnx运行Azure二头肌MCP NuGet包（推荐方法）

和。NET 10你可以使用 dnx 直接从NuGet包运行二头肌MCP服务器，而无需自己构建。

使用命令 dnx Azure.Bicep.McpServer --yes 将运行最新版本的二头肌MCP服务器。要在特定客户端中运行它，请参阅： 客户端设置指南.

选项2：从源代码构建

这种方法克隆了二头肌存储库并构建了MCP服务器。更新很简单 git pull 并重建。

初始设置

# Clone and build the Bicep repository
./scripts/Setup-BicepMCP.ps1

运行服务器

您可以直接从扩展路径运行MCP服务器。但是，不需要单独运行它，因为客户端会根据需要启动它。要在特定客户端中运行它，请参阅： 客户端设置指南。要在本地运行它，请参阅：

# Find the DLL
find bicep/src/Bicep.McpServer/bin/Release -name "Azure.Bicep.McpServer.dll"

# Run it
dotnet ./bicep/src/Bicep.McpServer/bin/Release/net10.0/Azure.Bicep.McpServer.dll

更新中

# Pull latest changes and rebuild the project
./scripts/Update-BicepRepo.ps1

选项3：从VS代码扩展中提取

如果您已经安装了二头肌VS代码扩展，则可以直接从中使用MCP服务器DLL。

找到扩展名

该扩展通常安装在：

• macOS: ~/.vscode/extensions/ms-azuretools.vscode-bicep-/
• Linux: ~/.vscode/extensions/ms-azuretools.vscode-bicep-/
• 视窗: %USERPROFILE%\.vscode\extensions\ms-azuretools.vscode-bicep-\

MCP服务器位于： bicepMcpServer/Azure.Bicep.McpServer.dll

从扩展运行

您可以直接从扩展路径运行MCP服务器。但是，不需要单独运行它，因为客户端会根据需要启动它。要在特定客户端中运行它，请参阅： 客户端设置指南。要在本地运行它，请参阅：

# Find your extension version
ls ~/.vscode/extensions/ | grep vscode-bicep

# Run the MCP server (replace  with your actual version)
dotnet ~/.vscode/extensions/ms-azuretools.vscode-bicep-/bicepMcpServer/Azure.Bicep.McpServer.dll

助手脚本

提供以下PowerShell脚本以简化设置和维护：

故障排除

• 在Windows上，确保在路径中避开反斜杠（例如。， C:\\path\\to\\Azure.Bicep.McpServer.dll)

客户端设置指南

• Claude代码设置 -为Claude Code（CLI）配置MCP服务器
• Claude桌面设置 -为Claude Desktop配置MCP服务器
• Codex CLI设置 -为Codex CLI配置MCP服务器
• **** -为Codex CLI配置MCP服务器
• LMStudio设置 -为LMStudio配置MCP服务器
• GitHub副本（VSCode）设置：建议使用Azure二头肌扩展的内置MCP支持。

运作原理

二头肌MCP服务器：

1. 使用 模型上下文协议 用于AI代理集成
2. 通过以下方式进行沟通 标准 （标准输入/输出）
3. 提供Azure资源类型信息和二头肌最佳实践的工具
4. 是建立在。NET 10.0使用微软的MCP SDK

参考文献

• Azure二头肌库
• 二头肌MCP服务器文档
• 模型上下文协议

了解更多

阅读我关于Azure二头肌MCP集成用例的博客文章：

-