🚀 Azure MCP（模型上下文协议）用于Claude桌面
Azure MCP是一种模型上下文协议（MCP）的实现方案，可让Claude桌面与Azure服务进行交互。借助该集成，Claude能通过自然语言对话直接查询和管理Azure资源，为用户带来便捷的操作体验。
🚀 快速开始
先决条件
- Node.js（v18或更高版本）
- Claude桌面应用程序
- 带有适当权限的Azure账户
- Azure CLI（可选，用于基于控制台的身份验证）
安装步骤
手动安装
- 克隆仓库：
git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp
- 安装依赖项：
npm install
- 配置Claude桌面：
- 打开
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的多种身份验证方法：
- 环境变量
- 管理 identity
- Azure CLI
- Visual Studio Code
- 交互式浏览器
服务器将按顺序尝试这些方法，直到其中一个成功。
使用方法
- 如果Claude桌面正在运行，请先关闭它（检查任务管理器）
- 启动Claude桌面
- 在聊天中，您可以提出与Azure相关的问题，例如：
- “你能获取所有可用的Azure账户和订阅吗？”
- “列出我当前订阅的所有资源组”
- “显示特定资源组中的所有虚拟机”
示例对话
您：你能获取所有可用的Azure账户和订阅吗？
Claude：我将帮助你列出所有可用的Azure租户和订阅。
[Claude将使用Azure MCP提取并显示信息]
✨ 主要特性
- Azure资源管理：与Azure资源管理客户端接口
- 订阅管理：列出和管理Azure订阅
- 租户管理：列出和选择Azure租户
- 自动身份验证：利用DefaultAzureCredential实现灵活的身份验证方法
- 错误处理：具有重试功能的健壮错误处理
- 干净响应格式：与Claude桌面兼容的正确格式化响应
🔧 技术细节
项目结构
azure-mcp/
├── src/
│ ├── launcher.ts # 服务器入口点
│ ├── AzureServer.ts # 主MCP服务器实现
│ └── LoggerService.ts # 日志实用工具
├── package.json
└── README.md
关键组件
- AzureMCPServer：实现MCP协议的主要服务器类
- HandleCallTool：处理传入工具请求
- ExecuteWithRetry：实现具有重试功能的弹性操作
📚 详细文档
故障排除
-
身份验证问题：
- 确保通过Azure CLI登录（
az login） - 检查使用服务主体时的环境变量
- 验证您的Azure账户是否有必要的权限
- 确保通过Azure CLI登录（
-
连接问题：
- 验证Claude桌面配置
- 检查配置文件中的路径是否与安装匹配
- 确保没有其他实例正在运行
-
常见错误：
NO_TENANT：使用“select-tenant”工具选择租户NO_CLIENTS：确保正确的初始化和身份验证CODE_EXECUTION_FAILED：检查Azure权限和连接
贡献
欢迎贡献！请随时提交拉取请求。
贡献者
- @calclavia - 与smithery.ai的集成
致谢
- Claude桌面团队为MCP实现
- Azure SDK团队为全面的SDK
- Microsoft Azure服务提供支持
📄 许可证
[在此处添加许可证信息，例如MIT License或其他适用的许可证]