Azure MCP (Model Context Protocol) for Claude Desktop

Azure MCP (Model Context Protocol) for Claude Desktop

site icon
2025.04.17 13
TypeScriptAzure集成自然语言接口开发效率
Azure MCP (Model Context Protocol) for Claude Desktop 是一个实现模型上下文协议的服务,使Claude Desktop能够通过自然语言对话与Azure服务进行交互。该集成允许Claude直接查询和管理Azure资源。
View on GitHub

Overview

基本能力

产品定位

Azure MCP 是一个桥梁服务,连接Claude Desktop和Azure云服务,使得用户可以通过自然语言交互来管理和查询Azure资源。

核心功能

  • Azure资源管理:与Azure资源管理客户端交互
  • 订阅管理:列出和管理Azure订阅
  • 租户管理:列出和选择Azure租户
  • 自动认证:利用DefaultAzureCredential支持多种认证方式
  • 错误处理:健壮的错误处理和重试机制
  • 响应格式化:格式化的响应,兼容Claude Desktop

适用场景

  • 通过自然语言查询Azure账户和订阅信息
  • 管理Azure资源组
  • 查询特定资源组中的虚拟机等资源

工具列表

  • AzureMCPServer:主服务器类,实现MCP协议
  • HandleCallTool:处理传入的工具请求
  • ExecuteWithRetry:实现重试逻辑,提高操作可靠性

常见问题解答

  1. 认证问题
  2. 确保通过Azure CLI登录(az login)
  3. 检查环境变量(如果使用服务主体)
  4. 验证Azure账户权限
  5. 连接问题
  6. 验证Claude Desktop配置
  7. 检查配置文件中的路径是否匹配
  8. 确保没有其他实例在运行
  9. 常见错误
  10. NO_TENANT:使用'select-tenant'工具选择租户
  11. NO_CLIENTS:确保正确初始化和认证
  12. CODE_EXECUTION_FAILED:检查Azure权限和连接

使用教程

使用依赖

  • Node.js (v18或更高)
  • Claude Desktop应用
  • 具有适当权限的Azure账户
  • Azure CLI(可选,用于CLI认证)

安装教程

  1. 克隆仓库:
git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp
  1. 安装依赖:
npm install
  1. 配置Claude Desktop:
  2. 打开claude_desktop_config.json
  3. 添加MCP配置

调试方式

  1. 关闭正在运行的Claude Desktop(检查任务管理器)
  2. 启动Claude Desktop
  3. 在聊天中可以询问Azure相关问题

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。