Azure MCP（模型上下文协议）用于Claude桌面

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

功能

• Azure资源管理：与Azure资源管理客户端接口
• 订阅管理：列出和管理Azure订阅
• 租户管理：列出和选择Azure租户
• 自动身份验证：利用DefaultAzureCredential实现灵活的身份验证方法
• 错误处理：具有重试功能的健壮错误处理
• 干净响应格式：与Claude桌面兼容的正确格式化响应

先决条件

• Node.js（v18或更高版本）
• Claude桌面应用程序
• 带有适当权限的Azure账户
• Azure CLI（可选，用于基于控制台的身份验证）

安装

手动安装

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 配置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
• 交互式浏览器

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

使用方法

1. 如果Claude桌面正在运行，请先关闭它（检查任务管理器）
2. 启动Claude桌面
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桌面配置
   • 检查配置文件中的路径是否与安装匹配
   • 确保没有其他实例正在运行

3. 常见错误：

   • NO_TENANT：使用“select-tenant”工具选择租户
   • NO_CLIENTS：确保正确的初始化和身份验证
   • CODE_EXECUTION_FAILED：检查Azure权限和连接

贡献

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

贡献者

• @calclavia - 与smithery.ai的集成

致谢

• Claude桌面团队为MCP实现
• Azure SDK团队为全面的SDK
• Microsoft Azure服务提供支持

许可证

[在此处添加许可证信息，例如MIT License或其他适用的许可证]