MCP Azure Pricing

🚀 Azure Pricing MCP Server

本項目提供了一個模型上下文協議（MCP）服務器，可讓你以編程方式查詢 Azure 資源定價。該服務器提供了一個結構化工作流程，用於從 Azure 零售價格 API 檢索定價信息。

🚀 快速開始

系統要求

• Python 3.8 或更高版本
• 能夠訪問 Azure 零售價格 API 的互聯網連接
• 安裝 Python 軟件包的權限
• 無需 Azure 賬戶或憑證（使用公共定價 API）

安裝步驟

1. 克隆倉庫：

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

2. 創建並激活虛擬環境：

   python -m venv .venv
   

   • Windows：

     .venv\Scripts\activate
     

   • macOS/Linux：

     source .venv/bin/activate
     

3. 安裝依賴項：

   pip install -r requirements.txt
   

啟動 MCP 服務器

source .venv/bin/activate  # 激活虛擬環境
python azure_pricing_mcp_server.py

服務器默認將在 http://0.0.0.0:8080 啟動。

可用端點

• GET /sse：用於 MCP 通信的服務器發送事件端點
• GET /tools：列出 MCP 服務器中可用的工具

MCP 客戶端配置

要配置 MCP 客戶端以連接到此服務器，請在你的 mcp_config.json 文件中添加以下內容：

"azure-pricing": {
  "serverUrl": "http://localhost:8080/sse"
}

此配置告知 MCP 客戶端使用 SSE 端點連接到本地 8080 端口上的服務器。請確保 URL 與服務器運行的地址和端口相匹配。

✨ 主要特性

• 通過簡單、結構化的工作流程查詢 Azure 定價數據
• 從 Azure 零售價格 API 獲取實時定價信息
• 瀏覽 Azure 服務系列、服務名稱和產品
• 計算 Azure 資源的月度成本

💻 使用示例

基礎用法

MCP 服務器提供了一個結構化的四步工作流程，用於訪問 Azure 定價信息：

1. 獲取服務系列 - 檢索可用的 Azure 服務系列列表
2. 獲取服務名稱 - 獲取特定系列內的服務名稱
3. 獲取產品 - 獲取與服務關聯的產品
4. 計算月度成本 - 計算特定產品的月度成本

高級用法

服務器提供了四個主要工具，形成了一個用於查詢 Azure 定價的邏輯工作流程：

1. list_service_families

描述：根據 Microsoft 的官方文檔列出 Azure 中所有可用的服務系列。

2. get_service_names

描述：獲取指定服務系列內的所有唯一服務名稱。 參數：

• service_family：要查詢的服務系列（例如，'Compute'、'Storage'）
• region：Azure 區域（默認：'westeurope'）
• max_results：要處理的最大結果數

3. get_products

描述：從特定服務系列中獲取產品名稱。 參數：

• service_family：要查詢的服務系列
• region：Azure 區域（默認：'westeurope'）
• type：價格類型（可選，例如，'Consumption'、'Reservation'）
• service_name：要過濾的服務名稱（可選）
• product_name_contains：過濾名稱包含此文本的產品（可選）
• limit：要返回的最大產品數（可選）

4. get_monthly_cost

描述：計算特定 Azure 產品的月度成本。 參數：

• product_name：產品的確切名稱（例如，'Azure App Service Premium v3 Plan'）
• region：Azure 區域（默認：'westeurope'）
• monthly_hours：每月小時數（默認：730）
• type：價格類型（可選，例如，'Consumption'）

🔧 技術細節

錯誤處理

MCP 服務器包含一個強大的錯誤處理系統，該系統：

• 在無法找到資源時提供描述性錯誤消息
• 正確處理 Azure API 錯誤
• 記錄詳細信息以用於調試目的

常見錯誤場景

• 產品未找到：當指定區域中不存在產品名稱時
• 服務系列未找到：當指定無效的服務系列時
• API 速率限制：當超過 Azure 零售價格 API 速率限制時
• 網絡錯誤：當服務器無法連接到 Azure API 時

侷限性

• 價格是基於 Azure 零售價格 API 的公共信息估算的
• 不包括所有可能的折扣、特定賬戶優惠或額外成本（如稅費或支持費用）
• Azure 零售價格 API 有速率限制，可能會影響大量請求時的性能
• 價格可能因所選區域和貨幣而異
• 並非所有 Azure 資源在所有區域都可用

🤝 貢獻

歡迎貢獻代碼！你可以按照以下步驟為這個項目做出貢獻：

1. 分叉倉庫
2. 創建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add some amazing feature'
4. 推送到分支：git push origin feature/amazing-feature
5. 打開拉取請求

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。