内容
# Azure Pricing MCP Server
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
该项目提供了一个模型上下文协议（Model Context Protocol，MCP）服务器，允许您以编程方式查询Azure资源定价。该服务器提供了一个结构化的工作流程，以从Azure零售价格API中检索定价信息。
## 特性
- 通过简单、结构化的工作流程查询Azure定价数据
- 从Azure零售价格API获取实时定价信息
- 浏览Azure服务系列、服务名称和产品
- 计算Azure资源的月度成本
## 系统要求
- Python 3.8或更高版本
- 需要互联网连接以访问Azure零售价格API
- 需要安装Python包的权限
- 不需要Azure账户或凭据（使用公共定价API）
## 安装
1. **克隆仓库：**
```bash
git clone https://github.com/sboludaf/mcp-azure-pricing.git
cd mcp-azure-pricing
```
2. **创建并激活虚拟环境：**
```bash
python -m venv .venv
```
* Windows:
```bash
.venv\Scripts\activate
```
* macOS/Linux:
```bash
source .venv/bin/activate
```
3. **安装依赖：**
```bash
pip install -r requirements.txt
```
## 使用
MCP服务器提供了一个结构化的四步工作流程，用于访问Azure定价信息：
1. **获取服务系列** - 检索可用的Azure服务系列列表
2. **获取服务名称** - 获取特定系列中的服务名称
3. **获取产品** - 获取与服务相关的产品
4. **计算月度成本** - 计算特定产品的月度成本
## 启动MCP服务器
```bash
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` 文件中添加以下内容：
```json
"azure-pricing": {
"serverUrl": "http://localhost:8080/sse"
}
```
此配置告诉MCP客户端通过SSE端点连接到本地服务器的8080端口。确保URL与您的服务器运行的地址和端口匹配。
## MCP工具
该服务器提供了四个主要工具，形成了查询Azure定价的逻辑工作流程：
### 1. list_service_families
**描述**：根据微软的官方文档列出所有可用的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. Fork该仓库
2. 创建一个功能分支：`git checkout -b feature/amazing-feature`
3. 提交您的更改：`git commit -m 'Add some amazing feature'`
4. 推送到分支：`git push origin feature/amazing-feature`
5. 打开一个Pull Request
## 许可证
该项目根据MIT许可证进行许可 - 详细信息请参见LICENSE文件。
MCP 市场