Py Az MCP

🚀 Azure MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) の実装で、Azure CLI コマンドを通じて Azure クラウドリソースへのプログラムによるアクセスを提供します。Azure サービスとのシームレスな統合をサポートし、幅広い Azure 操作を行うことができます。

✨ 主な機能

認証

• サービスプリンシパル認証のサポート
• 自動トークン管理
• 環境変数による設定

サポートされる Azure 操作

コンピューティング

• 仮想マシン (一覧表示、詳細表示、起動、停止、削除、再起動)
• 仮想マシンスケールセット (一覧表示、スケーリング、更新)
• Azure Kubernetes サービス (クラスターの一覧表示)

ストレージ

• ストレージアカウント (一覧表示、詳細表示、作成、删除)
• ストレージコンテナ (一覧表示、作成、删除)

アプリケーションサービス

• ウェブアプリ (一覧表示、詳細表示、作成、删除、起動、停止、再起動)
• 関数アプリ (一覧表示、詳細表示、删除、起動、停止、再起動)
• デプロイ管理

ネットワーク

• 仮想ネットワーク (一覧表示)
• ネットワークセキュリティグループ (一覧表示)
• プロキシ (一覧表示)

データベース

• Azure SQL データベース (一覧表示、詳細表示、作成、删除)
• MariaDB サーバー (一覧表示、詳細表示、作成、删除)

セキュリティ

• すべてのリソースの完全な一覧表示

📦 インストール

システム要件

• オペレーティングシステム: 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 以上

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：Azure CLI との統合を備えた主要な MCP サーバーの実装
• create_service_principal.py：Azure サービスプリンシパルを作成するユーティリティスクリプト
• main.py：パッケージのエントリポイント (プレースホルダー)
• pyproject.toml：プロジェクトの依存関係と設定
• .env：環境変数の設定 (Git で追跡されません)
• .python-version：Python のバージョン要件

エラー処理

サーバーには包括的なエラー処理が含まれています。

• すべての応答の JSON 検証
• Azure CLI のエラーのキャプチャと整形
• 認証エラーの処理
• パラメーターの検証

セキュリティに関する注意事項

• サービスプリンシパル認証を使用する
• 環境変数を使用して機密データを設定する
• 情報漏洩を防止するために適切な認証を実装する
• すべての入力パラメーターを検証する

コントリビューションガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. 新しいプルリクエストを作成します。

📄 ライセンス

MIT ライセンス

Copyright (c) 2025

本ソフトウェアおよび関連ドキュメントファイル（「ソフトウェア」）のコピーを無償で取得し、使用、複製、変更、結合、公開、配布、サブライセンス、および/または販売することができます。また、ソフトウェアを提供された個人に対しても同様のことができます。ただし、以下の条件を満たす必要があります。

本著作権表示および本ライセンス表示は、すべてのコピーまたはソフトウェアの重要な部分に含まれていなければなりません。

ソフトウェアは「現状のまま」提供され、商品性、特定の目的への適合性、または非侵害性に関する明示または暗示の保証を含む、いかなる形式の保証も行われません。いかなる場合も、作者または著作権者は、ソフトウェアの使用またはその他の方法によって生じるいかなる請求、損害、またはその他の責任についても一切の責任を負いません。