Blue Bridge

Blue Bridge

シークレットを使わない認証で Azure リソースをクエリおよび管理するための、Model Context Protocol (MCP) サーバー向けサンプルプロンプトとレシピです。
シナリオには次のものが含まれます。

• Azure Managed Grafana
• Azure Data Explorer (Kusto)
• Azure Resource Graph
• Azure Resource Manager

認証には、サインイン済みの Azure CLI アカウントまたはマネージド ID が使用されます。パスワードやキーは保存されません。

---

✨ デモ

1. 'manual-for-ai.md' を参照して、コストを節約するために停止できる VM を 5 台教えてください。

   

2. 'manual-for-ai.md' を参照して、コストを節約するために停止できる VM を 2 台見つけてください。また、それらを停止してください。各 VM について、実行前に許可を求めてください。

   

3. サブスクリプション '3a7edf7d-1488-4017-a908-e50d0a1642a6' の CPU クォータを取得してください。

   

---

🚀 クイックスタート

0 · リポジトリをクローンする

リポジトリをクローンして、manual-for-ai.md に記載されているレシピや使用例など、必要なファイルを取得します。

git clone https://github.com/Azure/blue-bridge.git
cd blue-bridge

1 · コンテナーを実行する

Blue Bridge は、追加の設定なしで Azure Resource Graph と Azure Resource Manager をすぐに利用できます。

Azure Managed Grafana または Azure Data Explorer (Kusto) に接続するには、コンテナーの実行時に対応する環境変数を設定します。

必要なオプションの環境変数を設定し、イメージを起動します。

docker run --name bluebridge -p 6688:6688 \
  -e AzureManagedGrafanaEndpoint=https://<my‑grafana>.wcus.grafana.azure.com \
  -e KustoUri=https://<my‑kusto>.westus2.kusto.windows.net \
  bluebridge.azurecr.io/bluebridge:latest

Kusto のみが必要な場合：

docker run --name bluebridge -p 6688:6688 \
  -e KustoUri=https://<my‑kusto>.westus2.kusto.windows.net \
  bluebridge.azurecr.io/bluebridge:latest

外部サービスを使用しない場合：

docker run --name bluebridge -p 6688:6688 \
  bluebridge.azurecr.io/bluebridge:latest

2 · 一度だけ認証する

初回起動時、コンテナーに次のようなデバイスコードの入力を求めるメッセージが表示されます。

To sign in, use a web browser to open the page https://microsoft.com/devicelogin
and enter the code ABCD‑EFGH to authenticate.

リンクを開き、コードを入力して、同意します。
その後、サーバーは http://localhost:6688 で利用可能になります。

3 · MCP ホストに追加する

{
  "mcpServers": {
    "blue-bridge": {
      "url": "http://localhost:6688/sse",
      "transportType": "sse",
      "timeout": 60,
      "disabled": false,
      "autoApprove": []
    }
  }
}

4 · 簡単なテストを実行する

MCP ホストに次のように尋ねます。

Given 'manual-for-ai.md', show me 5 VMs that I can turn off machines to save money.

---

🔧 環境変数

変数	用途	必須
AzureManagedGrafanaEndpoint	Azure Managed Grafana のエンドポイント URL	いいえ
KustoUri	Azure Data Explorer (Kusto) クラスターの URI	いいえ
UseManagedIdentity	マネージド ID を使用するには true に設定します。	いいえ
ManagedIdentityClientId	使用するマネージド ID のクライアント ID。	いいえ

UseManagedIdentity が true に設定されている場合、Blue Bridge はコンピューティングリソースで利用可能なマネージド ID を使用して認証を試みます。マネージド ID が 1 つ（システム割り当てまたはユーザー割り当て）だけの場合は、自動的に機能します。

コンピューティングリソースに複数のマネージド ID がある場合は、ManagedIdentityClientId 環境変数に使用するマネージド ID のクライアント ID を設定して、使用する ID を指定する必要があります。ManagedIdentityClientId を設定するとマネージド ID の使用が暗黙的に指定されるため、この場合 UseManagedIdentity を true に設定する必要はありません。

---

📚 リンク

• ドキュメントとサンプル: https://aka.ms/blue-bridge