MCP Azure Pricing

🚀 Azure Pricing MCP Server

このプロジェクトは、Azureリソースの価格をプログラムで照会できるModel Context Protocol (MCP)サーバーを提供します。サーバーは、Azure Retail Prices APIから価格情報を取得するための構造化されたワークフローを提供します。

🚀 クイックスタート

このプロジェクトを使ってAzureリソースの価格を照会するには、以下の手順に従ってください。

✨ 主な機能

• シンプルで構造化されたワークフローを通じてAzureの価格データを照会する
• Azure Retail Prices APIからリアルタイムの価格情報を取得する
• Azureのサービスファミリー、サービス名、および製品をナビゲートする
• Azureリソースの月額コストを計算する

📦 インストール

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サーバーは、Azureの価格情報にアクセスするための構造化された4段階のワークフローを提供します。

1. サービスファミリーを取得する - 利用可能なAzureサービスファミリーのリストを取得する
2. サービス名を取得する - 特定のファミリー内のサービス名を取得する
3. 製品を取得する - サービスに関連付けられた製品を取得する
4. 月額コストを計算する - 特定の製品の月額コストを計算する

高度な使用法

MCPサーバーの起動

source .venv/bin/activate  # 仮想環境をアクティブ化する
python azure_pricing_mcp_server.py

サーバーはデフォルトでhttp://0.0.0.0:8080で起動します。

利用可能なエンドポイント

• GET /sse: MCP通信のためのServer-Sent Eventsエンドポイント
• GET /tools: MCPサーバーで利用可能なツールのリストを表示する

MCPクライアントの設定

このサーバーに接続するようにMCPクライアントを設定するには、mcp_config.jsonファイルに以下を追加します。

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

この設定により、MCPクライアントはSSEエンドポイントを使用してポート8080のローカルサーバーに接続します。URLがサーバーが実行されているアドレスとポートと一致していることを確認してください。

📚 ドキュメント

MCPツール

サーバーは、Azureの価格を照会するための論理的なワークフローを形成する4つの主要なツールを提供します。

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 Retail Prices APIのレート制限を超えた場合
• ネットワークエラー: サーバーがAzure APIに接続できない場合

制限事項

• 価格は、Azure Retail Prices APIからの公開情報に基づく見積もりです
• すべての可能な割引、アカウント固有のオファー、または税やサポートなどの追加コストは含まれていません
• Azure Retail Prices 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ファイルを参照してください。