适用于 Claude Desktop 的 Azure MCP（模型上下文协议）

模型上下文协议 (MCP) 实现，使 Claude Desktop 能够与 Azure 服务交互。此集成允许 Claude 直接通过自然语言对话查询和管理 Azure 资源。

特征

• Azure 资源管理：与 Azure 资源管理客户端接口

• 订阅管理：列出和管理 Azure 订阅

• 租户管理：列出并选择 Azure 租户

• 自动身份验证：利用 DefaultAzureCredential 实现灵活的身份验证方法

• 错误处理：强大的错误处理功能，可重试瞬时故障

• 清洁响应格式：与 Claude Desktop 兼容的正确格式的响应

先决条件

• Node.js（v18 或更高版本）

• Claude 桌面应用程序

• 具有适当权限的 Azure 帐户

• Azure CLI（可选，用于基于 CLI 的身份验证）

安装

手动安装

1. 克隆存储库：

2. 安装依赖项：

3. 配置Claude桌面：

   • 打开claude_desktop_config.json

   • 添加以下 MCP 配置：

验证

服务器通过DefaultAzureCredential支持多种身份验证方法：

• 环境变量

• 托管标识

• Azure CLI

• Visual Studio 代码

• 交互式浏览器

服务器将自动按顺序尝试这些方法，直到成功为止。

用法

1. 如果 Claude Desktop 正在运行，请关闭它（检查任务管理器）

2. 启动 Claude Desktop

3. 在聊天中，您现在可以询问与 Azure 相关的问题，例如：

   • “您能获得所有可用的 Azure 帐户和订阅吗？”

   • “列出我的订阅中的所有资源组”

   • “显示特定资源组中的所有虚拟机”

对话示例

发展

项目结构

关键组件

• AzureMCPServer ：实现 MCP 协议的主服务器类

• HandleCallTool ：处理传入的工具请求

• ExecuteWithRetry ：实现弹性操作的重试逻辑

故障排除

1. 身份验证问题：

   • 确保您已通过 Azure CLI ( az login ) 登录

   • 如果使用服务主体，请检查环境变量

   • 验证 Azure 帐户是否具有必要的权限

2. 连接问题：

   • 验证 Claude Desktop 配置

   • 检查配置文件中的路径是否符合您的安装

   • 确保没有其他实例正在运行

3. 常见错误：

   • NO_TENANT ：使用“select-tenant”工具选择租户

   • NO_CLIENTS ：确保正确的初始化和身份验证

   • CODE_EXECUTION_FAILED ：检查 Azure 权限和连接

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

贡献者

• @calclavia——与 smithery.ai 集成

致谢

• Claude Desktop 团队负责 MCP 实施

• Azure SDK 团队提供全面的 SDK

• 用于实现 AI 服务集成的模型上下文协议

安全说明

此实现遵循 Azure 安全最佳实践：

• 没有硬编码凭证

• 安全凭证链实施

• 正确的错误处理和清理

对于安全问题或漏洞，请创建问题。