Py Az MCP

🚀 Azure MCP 服務器

Azure MCP 服務器是一個模型上下文協議 (MCP) 服務器實現，藉助 Azure CLI 命令，為用戶提供對 Azure 雲資源的程序化訪問能力。該服務器能與 Azure 服務實現無縫集成，支持廣泛的 Azure 操作，極大提升了用戶對 Azure 資源的管理效率。

✨ 主要特性

身份驗證

• 支持服務主體身份驗證，確保安全可靠的訪問。
• 具備自動令牌管理功能，減少人工操作。
• 可通過環境變量進行配置，靈活方便。

支持的 Azure 操作

計算

• 虛擬機：支持列出、顯示、啟動、停止、刪除、重啟等操作。
• 虛擬機擴展集：支持列出、縮放、更新操作。
• Azure Kubernetes 服務：支持列出群集。

存儲

• 存儲帳戶：支持列出、顯示、創建、刪除操作。
• 存儲容器：支持列出、創建、刪除操作。

應用服務

• 網站應用：支持列出、顯示、創建、刪除、啟動、停止、重啟操作。
• 函數應用：支持列出、顯示、刪除、啟動、停止、重啟操作。
• 支持部署管理。

網絡

• 虛擬網絡：支持列出操作。
• 網絡安全組：支持列出操作。
• 代理：支持列出操作。

數據庫

• Azure SQL 數據庫：支持列出、顯示、創建、刪除操作。
• MariaDB 服務器：支持列出、顯示、創建、刪除操作。

安全

• 可獲取所有資源的完整列表。

📦 安裝指南

使用 pip 安裝 MCP CLI 和其他依賴項

打開終端並運行以下命令：

pip install mcp[cli] python-dotenv asyncio azure-cli

配置環境變量

創建一個名為 .env 的文件，並添加以下內容：

AZURE_TENANT_ID=your_tenant_id_here
AZURE_CLIENT_ID=your_client_id_here
AZURE_CLIENT_SECRET=your_client_secret_here
MCP_SERVER_ADDRESS=http://localhost:8080

啟動 MCP 服務器

運行以下命令啟動 MCP 服務器：

python -m mcp.server --config-path ./config.json

📚 詳細文檔

配置說明

創建服務主體

1. 登錄到 Azure 門戶
2. 點擊右上角的“更多服務” > “Azure Active Directory”
3. 在左側菜單中選擇“企業應用註冊”
4. 點擊“新建註冊”，填寫應用程序信息並創建
5. 創建完成後，在“證書和密鑰”部分生成新的客戶端密鑰

示例命令

az login --service-principal -u <CLIENT_ID> -p <CLIENT_SECRET> --tenant <TENANT_ID>

項目結構

• server-azure.py：主要的 MCP 服務器實現，帶 Azure CLI 集成
• create_service_principal.py：創建 Azure 服務主體的實用腳本
• main.py：包入口點（佔位符）
• pyproject.toml：項目依賴和配置
• .env：環境變量配置（不在 Git 中跟蹤）
• .python-version：Python 版本要求

錯誤處理

服務器包含全面的錯誤處理：

• 所有響應的 JSON 驗證
• Azure CLI 錯誤捕獲和格式化
• 身份驗證錯誤處理
• 參數驗證

安全注意事項

• 使用服務主體身份驗證
• 支持環境變量配置敏感數據
• 實現適當的身份驗證以防止信息洩露
• 驗證所有輸入參數

貢獻指南

1. 叉取倉庫
2. 創建你的功能分支
3. 提交你的更改
4. 推送到分支
5. 創建新的拉取請求

🔧 技術細節

先決條件

系統要求

• 操作系統: Windows 10/11 或更高版本 (64 位)，macOS Ventura 13.2+，Ubuntu 22.04 LTS 或更高版本
• 內存: 至少 4 GB RAM
• 磁盤空間: 至少 5 GB 可用空間

軟件要求

• Python: 3.10 或更高版本
• Azure CLI: 2.57.0 或更高版本 (在終端中運行 az --version 檢查)
• Node.js: v18.14.2 或更高版本
• npm: 9.6.0 或更高版本

📄 許可證

MIT 許可證

版權 (c) 2025

允許任何人均可免費獲得本軟件及其關聯文檔文件（“軟件”），並可以無限制地處理，包括但不限於以下權利：使用、複製、修改、合併、發佈、分發、轉授及/或出售軟件副本，並允許個人向其提供軟件的人進行上述行為，前提是以下條件必須滿足：

本版權聲明和本許可聲明必須包含在所有副本或軟件重大部分中。

軟件按“原樣”提供，不做任何形式的擔保，包括但不限於對適銷性、適合特定用途或不侵權的明示或暗示保證。在任何情況下，作者或版權持有人均不對因使用此軟件或其它方式產生的任何索賠、損害或其他責任承擔任何責任。