Azure MCP

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

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

🚀 快速開始

要使用Azure MCP，您需要滿足一定的先決條件，並且按照特定的步驟進行安裝和配置。

先決條件

• 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資源管理：與Azure資源管理客戶端接口，方便對Azure資源進行管理。
• 訂閱管理：可列出和管理Azure訂閱。
• 租戶管理：支持列出和選擇Azure租戶。
• 自動身份驗證：利用DefaultAzureCredential實現靈活的身份驗證方法。
• 錯誤處理：具備重試功能的健壯錯誤處理機制。
• 乾淨響應格式：提供與Claude桌面兼容的正確格式化響應。

📚 詳細文檔

項目結構

azure-mcp/
├── src/
│   ├── launcher.ts       # 服務器入口點
│   ├── AzureServer.ts    # 主MCP服務器實現
│   └── LoggerService.ts  # 日誌實用工具
├── package.json
└── README.md

關鍵組件

• AzureMCPServer：實現MCP協議的主要服務器類。
• HandleCallTool：處理傳入工具請求。
• ExecuteWithRetry：實現具有重試功能的彈性操作。

🔧 技術細節

身份驗證機制

服務器支持通過DefaultAzureCredential的多種身份驗證方法，包括環境變量、管理 identity、Azure CLI、Visual Studio Code和交互式瀏覽器。服務器會按順序嘗試這些方法，直至其中一個成功，從而保證了身份驗證的靈活性和可靠性。

錯誤處理

具備重試功能的健壯錯誤處理機制，當出現錯誤時，系統會嘗試重試，以確保操作的順利進行。

🚧 故障排除

身份驗證問題

• 確保通過Azure CLI登錄（az login）。
• 檢查使用服務主體時的環境變量。
• 驗證您的Azure賬戶是否有必要的權限。

連接問題

• 驗證Claude桌面配置。
• 檢查配置文件中的路徑是否與安裝匹配。
• 確保沒有其他實例正在運行。

常見錯誤

• NO_TENANT：使用“select-tenant”工具選擇租戶。
• NO_CLIENTS：確保正確的初始化和身份驗證。
• CODE_EXECUTION_FAILED：檢查Azure權限和連接。

🤝 貢獻

歡迎大家貢獻代碼！請隨時提交拉取請求。

貢獻者

• @calclavia - 與smithery.ai的集成

🙏 致謝

• Claude桌面團隊為MCP實現提供了支持。
• Azure SDK團隊提供了全面的SDK。
• Microsoft Azure服務提供了基礎支持。

📄 許可證

[在此處添加許可證信息，例如MIT License或其他適用的許可證]