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

一个使Claude Desktop能够与Azure服务交互的Model Context Protocol (MCP) 实现。此集成允许Claude通过自然语言对话直接查询和管理Azure资源。

特性

• Azure资源管理：与Azure Resource Management客户端接口
• 订阅管理：列出和管理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：使用'选择租户'工具选择一个租户
   • NO_CLIENTS：确保初始化和身份验证正确
   • CODE_EXECUTION_FAILED：检查Azure权限和连接

贡献

欢迎贡献！请随意提交Pull Request。

贡献者

• @calclavia - 与smithery.ai的集成

致谢

感谢以下团队：

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

安全注意事项

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

• 输入验证：确保所有用户提供的数据经过适当验证
• 最小权限：使用受限的凭据进行身份验证和授权
• 日志记录和监控：实施详细日志记录并持续监控以检测潜在问题

联系方式

如需联系，请访问项目主页或在GitHub上提交问题。

注意：此文档为示例，实际内容可能有所不同。请参考官方文档获取准确信息。

Azure MCP 项目指南

简介

Azure MCP (Model Context Protocol) 是一个允许与 Azure 服务进行交互的协议。通过本指南，您将了解如何配置和使用 Azure MCP 来管理资源、订阅和租户。

安装与配置

先决条件

• 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"
           ]
         }
       }
     }
     

使用指南

基本操作

1. 启动 Claude Desktop。
2. 在聊天界面中输入以下命令以测试 Azure MCP 连接：
   • 获取所有可用的 Azure 账户和订阅：

     /azure/list_accounts
     

   • 列出特定订阅中的资源组：

     /azure/subscriptions/{subscription_id}/resource_groups
     

   • 显示虚拟机信息：

     /azure/vm/{subscription_id}/{resource_group}/{vm_name}
     

示例对话

你：/azure/list_accounts
Claude：正在获取你的 Azure 账户和订阅信息...
完成！以下是可用的订阅列表：
- 订阅 1: ID: sub-12345678, 名称: Production
- 订阅 2: ID: sub-abcdefgh, 名称: Development

你可以使用这些订阅 ID 继续执行其他操作。

故障排除

常见问题解答

1. 无法连接到 Azure：

   • 确保您的 Azure 账户已正确配置，并且网络连接正常。
   • 检查是否启用了正确的 API 和权限。

2. 错误：NO_TENANT：

   • 使用 /azure/select_tenant {tenant_id} 命令选择一个租户。

3. 错误：UNAUTHORIZED：

   • 确保您使用的凭据具有足够的权限。
   • 检查是否启用了 Azure Active Directory 应用注册。

安全注意事项

• 输入验证：所有用户提供的数据均经过严格验证，防止未授权访问。
• 最小权限：默认配置使用受限的管理员凭据进行身份验证和授权。
• 日志记录与监控：实施详细的日志记录，并持续监控以检测潜在的安全问题。

贡献指南

欢迎为项目做出贡献！请参考 GitHub 仓库 提交功能请求或修复问题。

贡献者名单

• @calclavia - 集成与 Smithery 的协作

致谢

感谢以下团队和项目的贡献：

• Claude Desktop 团队 - 为 MCP 实现提供支持。
• Azure SDK 团队 - 提供了强大的工具和库。
• Model Context Protocol 社区 - 开源项目的灵感来源。

联系方式

如需联系，请访问 项目主页 或在 GitHub 上提交问题。

注意：此文档为示例，实际内容可能有所不同。请参考官方文档获取准确信息。