Azure MCP (Model Context Protocol) for Claude Desktop

<a href="https://glama.ai/mcp/servers/8lqipo67ap"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1849299886,2766448192&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

这是一个实现，使 Claude Desktop 能够与 Azure 服务进行交互。这种集成允许 Claude 通过自然语言对话直接查询和管理 Azure 资源。

功能

• Azure 资源管理：与 Azure 资源管理客户端接口
• 订阅管理：列出并管理 Azure 订阅
• 租户管理：列出并选择 Azure 租户
• 自动认证：利用 DefaultAzureCredential 实现灵活的认证方法
• 错误处理：针对瞬时故障的重试机制的健壮错误处理
• 干净的响应格式化：与 Claude Desktop 兼容的正确格式化的响应

预备条件

• Node.js (v18 或更高版本)
• Claude Desktop 应用程序
• 具有适当权限的 Azure 帐户
• Azure CLI（可选，用于基于 CLI 的认证）

安装

手动安装

1. 克隆仓库：

git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp

2. 安装依赖项：

npm install

3. 配置 Claude Desktop：
   • 打开 claude_desktop_config.json
   • 添加以下 MCP 配置：

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "azure": {
      "command": "tsx",
      "args": [
        "C:/Users/[YourUsername]/path/to/azure-mcp/src/launcher.ts"
      ]
    }
  }
}

认证

该服务器支持通过 DefaultAzureCredential 实现多种认证方法：

• 环境变量
• 管理身份
• Azure CLI
• Visual Studio Code
• 交互式浏览器

服务器会按顺序尝试这些方法，直到其中一个成功为止。

使用

1. 如果 Claude Desktop 正在运行，请关闭它（检查任务管理器）
2. 启动 Claude Desktop
3. 在聊天中，您可以询问与 Azure 相关的问题，例如：
   • "你能获取所有可用的 Azure 帐户和订阅吗？"
   • "列出我订阅中的所有资源组"
   • "显示特定资源组中的所有虚拟机"

示例对话

您：你能获取所有可用的 Azure 帐户和订阅吗？
Claude：我会帮助您列出所有可用的 Azure 租户和订阅。
[Claude 将使用 Azure MCP 获取并显示信息]

开发

项目结构

azure-mcp/
├── src/
│   ├── launcher.ts       # 服务器入口点
│   ├── AzureServer.ts    # 主 MCP 服务器实现
│   └── LoggerService.ts  # 日志工具
├── package.json
└── README.md

关键组件

• AzureMCPServer：实现 MCP 协议的主要服务器类
• HandleCallTool：处理传入的工具请求
• ExecuteWithRetry：实现重试逻辑以实现弹性操作

故障排除

1. 认证问题：

   • 确保您已通过 Azure CLI 登录 (az login)
   • 检查环境变量，如果您使用的是服务主体
   • 确认您的 Azure 帐户具有必要的权限

2. 连接问题：

   • 检查 Claude Desktop 配置
   • 检查配置文件中的路径是否与您的安装匹配
   • 确保没有其他实例正在运行

3. 常见错误：

   • NO_TENANT：使用 'select-tenant' 工具选择一个租户
   • NO_CLIENTS：确保正确的初始化和认证
   • CODE_EXECUTION_FAILED：检查 Azure 权限和连接

贡献

欢迎贡献！请随时提交拉取请求。

贡献者

• @calclavia - 与 smithery.ai 的集成

致谢

• Claude Desktop 团队为 MCP 实现
• Azure SDK 团队为全面的 SDK
• Model Context Protocol 为实现 AI 服务集成

安全注意事项

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

• 不硬编码凭据
• 实现安全的凭据链
• 正确的错误处理和净化

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