Azure Resource Management

🚀 Azure MCP（模型上下文協議）用於Claude Desktop

Azure MCP（模型上下文協議）是一個使Claude Desktop能夠與Azure服務交互的實現。通過此集成，Claude可以通過自然語言對話直接查詢和管理Azure資源，極大地提升了操作的便捷性。

🚀 快速開始

Azure MCP是一個允許與Azure服務進行交互的協議。藉助本指南，您能夠了解如何配置和使用Azure MCP來管理資源、訂閱和租戶。

✨ 主要特性

• Azure資源管理：與Azure Resource Management客戶端接口，可對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"
      ]
    }
  }
}

💻 使用示例

基礎用法

基本操作

1. 若Claude Desktop正在運行，請先關閉它（可檢查任務管理器）。
2. 啟動Claude Desktop。
3. 在聊天中，您可以詢問與Azure相關的問題，例如：
   • 獲取所有可用的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 繼續執行其他操作。

高級用法

在聊天中，您還可以使用自然語言詢問與Azure相關的問題，例如：

你：你能獲取所有可用的Azure賬戶和訂閱嗎？
Claude：我可以幫助你列出所有可用的Azure租戶和訂閱。
[Claude將使用Azure MCP來獲取並顯示信息]

🔧 技術細節

認證

該服務器支持通過DefaultAzureCredential的多種身份驗證方法：

• 環境變量
• 管理身份
• Azure CLI
• Visual Studio Code
• 瀏覽器交互式

服務器將按順序嘗試這些方法，直到其中一個成功。

項目結構

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：使用'選擇租戶'工具或 /azure/select_tenant {tenant_id} 命令選擇一個租戶。
   • NO_CLIENTS：確保初始化和身份驗證正確。
   • CODE_EXECUTION_FAILED：檢查Azure權限和連接。
   • UNAUTHORIZED：確保您使用的憑據具有足夠的權限，檢查是否啟用了Azure Active Directory應用註冊。
4. 無法連接到Azure：
   • 確保您的Azure賬戶已正確配置，並且網絡連接正常。
   • 檢查是否啟用了正確的API和權限。

🤝 貢獻

歡迎貢獻！請隨意提交Pull Request。

貢獻者

• @calclavia - 與smithery.ai的集成

🙏 致謝

感謝以下團隊：

• Claude Desktop團隊為MCP實現提供支持。
• Azure SDK團隊提供了全面的SDK。
• Model Context Protocol使AI服務集成成為可能。

⚠️ 安全注意事項

此實現遵循安全最佳實踐：

• 輸入驗證：確保所有用戶提供的數據經過嚴格驗證，防止未授權訪問。
• 最小權限：使用受限的憑據進行身份驗證和授權。
• 日誌記錄和監控：實施詳細日誌記錄並持續監控，以便及時檢測潛在問題。

📞 聯繫方式

如需聯繫，請訪問項目主頁或在GitHub上提交問題。

注意：此文檔為示例，實際內容可能有所不同。請參考官方文檔獲取準確信息。