モデル コンテキスト プロトコル (MCP) サーバーを使用して Azure Kubernetes Service (AKS) クラスターを AI エージェントに接続する

AKS-MCP の使用を開始する最も簡単な方法は、 VS Code 用 Azure Kubernetes Service 拡張機能を使用することです。 AKS 拡張機能は、バイナリのダウンロード、更新、構成を自動的に処理し、常に最適な設定で最新バージョンを使用できるようにします。

手順 1: AKS 拡張機能をインストールする

1. VS Code を開き、[拡張機能] に移動します (Windows/Linux のCtrl+Shift+X または macOS の Cmd+Shift+X )。
2. Azure Kubernetes Service を検索します。
3. 公式の Microsoft AKS 拡張機能をインストールします。

手順 2: AKS-MCP サーバーを起動する

1. コマンド パレットを開きます (Windows/Linux ではCtrl+Shift+P、macOS ではCmd+Shift+P)。
2. 検索と実行: AKS: AKS MCP サーバーのセットアップ。

インストールが成功すると、 MCP: List Servers (コマンド パレット経由) にサーバーが表示されます。 そこから、MCP サーバーを起動するか、その状態を表示できます。

手順 3: AKS-MCP の使用を開始する

起動すると、MCP サーバーが [Copilot Chat: Configure Tools ]\(ツールの構成\) ドロップダウンで MCP Server: AKS MCP の下に表示され、AKS 環境に基づいてコンテキスト プロンプトを強化できます。 既定では、すべての AKS-MCP サーバー ツールが有効になっています。 使用可能なツールの一覧を確認し、シナリオに必要のないツールを無効にすることができます。

"すべての AKS クラスターを一覧表示する" などのプロンプトを試して、AKS-MCP サーバーのツールの使用を開始します。

VS Code 拡張機能を使用せずに直接バイナリを使用する場合:

手順 1: バイナリをダウンロードする

プラットフォームを選択し、最新の AKS-MCP バイナリをダウンロードします。

手順 2: VS Code を構成する

ダウンロードしたバイナリへのパスを使用して、ワークスペース ルートに .vscode/mcp.json ファイルを作成します。

ワークスペース固有の構成 (プロジェクト固有の使用に推奨):

{
  "servers": {
    "aks-mcp-server": {
      "type": "stdio",
      "command": "<path-to-binary>",
      "args": [
        "--transport", "stdio"
      ]
    }
  }
}

ユーザー レベルの構成 (すべてのワークスペースに永続的):

VS Code ユーザー設定 JSON にCtrl+, または Cmd+,を追加し、その後、"mcp" を検索します。

{
  "github.copilot.chat.mcp.servers": {
    "aks-mcp-server": {
      "type": "stdio",
      "command": "<path-to-binary>",
      "args": [
        "--transport", "stdio"
      ]
    }
  }
}

手順 3: AKS-MCP サーバー ツールを読み込む

1. VS Code を再起動して、新しい MCP サーバー構成を読み込みます。
2. VS Code で GitHub Copilot を開き、 エージェント モードに切り替えます。
3. [ ツール ] ボタンを選択すると、使用可能なツールの一覧が表示されます。
4. AKS-MCP ツールが一覧に表示されることを確認します。
5. "サブスクリプション xxx ですべての AKS クラスターを一覧表示する" のようなプロンプトを試してください。

Docker MCP Toolkit の公式 Docker イメージを使用するか、コンテナー化された MCP 構成として、AKS-MCP サーバーを実行できます。

オプション 1: Docker MCP Toolkit

1. Docker Desktop を開きます。
2. 左側のサイドバーで MCP Toolkit を選択します。
3. [カタログ] タブで "aks" を検索します。
4. AKS-MCP サーバー カードを選択します。
5. 右上隅の + を選択して、サーバーを有効にします。
6. [構成] タブを使用してサーバーを 構成 します。
   • azure_dir[REQUIRED]: Azure 資格情報ディレクトリへの絶対パス (たとえば、 /home/user/.azure)
   • kubeconfig[REQUIRED]: kubeconfig ファイルへの絶対パス (たとえば、 /home/user/.kube/config)
   • access_level[REQUIRED]: 必要に応じて readonly、 readwrite、または admin に設定します
   • container_user[OPTIONAL]: コンテナーを実行するユーザー名または UID (既定値は mcp)。 Linux で Docker Engine を実行している場合は、ホスト ユーザー ID ( 1000 など) を使用します。

オプション 2: コンテナー化された MCP 構成

ホストから資格情報をマウントする (推奨):

{
  "mcpServers": {
    "aks": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--user", "<your-user-id>",
        "-v", "~/.azure:/home/mcp/.azure",
        "-v", "~/.kube:/home/mcp/.kube",
        "ghcr.io/azure/aks-mcp:latest",
        "--transport", "stdio"
      ]
    }
  }
}

代わりにコンテナー内の資格情報をフェッチするには、ボリューム マウントを省略し、コンテナーの起動後に次のコマンドを実行します。

# Login to Azure CLI
docker exec -it <container-id> az login --use-device-code

# Get kubeconfig
docker exec -it <container-id> az aks get-credentials -g <resource-group> -n <cluster-name>

Claude Desktop などの他の MCP と互換性のある AI クライアントの場合は、MCP 構成でサーバーを構成します。

{
  "mcpServers": {
    "aks": {
      "command": "<path-to-binary>",
      "args": [
        "--transport", "stdio"
      ]
    }
  }
}

コマンド ラインから直接サーバーを実行することもできます。

./aks-mcp --transport stdio

コマンド ライン オプション:

環境変数:

• USE_LEGACY_TOOLS: 統合ツールの代わりに従来の特殊なツールを使用するように true に設定します (既定値: false)
• 標準の Azure 認証環境変数がサポートされています (AZURE_TENANT_ID、 AZURE_CLIENT_ID、 AZURE_CLIENT_SECRET、 AZURE_SUBSCRIPTION_ID)

ワークロード ID は、Kubernetes ServiceAccount を Azure マネージド ID にリンクすることで、パスワードレス認証を提供します。

1. AKS クラスターで OIDC を有効にする

az aks update \
  --resource-group <your-resource-group> \
  --name <your-aks-cluster> \
  --enable-oidc-issuer \
  --enable-workload-identity

2. マネージド ID を作成し、RBAC アクセス許可を割り当てる

# Create identity
az identity create --resource-group <your-resource-group> --name aks-mcp-identity --location <your-location>

# Get IDs
IDENTITY_CLIENT_ID=$(az identity show --resource-group <your-resource-group> --name aks-mcp-identity --query "clientId" -o tsv)
IDENTITY_PRINCIPAL_ID=$(az identity show --resource-group <your-resource-group> --name aks-mcp-identity --query "principalId" -o tsv)

# Assign Reader role (use Contributor for readwrite access)
az role assignment create --role "Reader" --assignee-object-id $IDENTITY_PRINCIPAL_ID --assignee-principal-type ServicePrincipal --scope "/subscriptions/<subscription-id>"

3. フェデレーション ID 資格情報を作成する

AKS_OIDC_ISSUER=$(az aks show --resource-group <your-resource-group> --name <your-aks-cluster> --query "oidcIssuerProfile.issuerUrl" -o tsv)

az identity federated-credential create \
  --name "aks-mcp-federated-credential" \
  --identity-name aks-mcp-identity \
  --resource-group <your-resource-group> \
  --issuer $AKS_OIDC_ISSUER \
  --subject "system:serviceaccount:aks-mcp:aks-mcp" \
  --audience api://AzureADTokenExchange

4. ワークロード ID を有効にしてインストールする

helm install aks-mcp . \
  --namespace aks-mcp \
  --create-namespace \
  --set workloadIdentity.enabled=true \
  --set azure.clientId=$IDENTITY_CLIENT_ID \
  --set azure.subscriptionId=<your-subscription-id>

OAuth 認証を有効にして、読み取り/書き込み操作または管理者操作にユーザーのサインインを要求します。

helm install aks-mcp . \
  --namespace aks-mcp \
  --create-namespace \
  --set app.accessLevel=readwrite \
  --set oauth.enabled=true \
  --set oauth.tenantId=<your-tenant-id> \
  --set oauth.clientId=<your-oauth-client-id> \
  --set azure.subscriptionId=<your-subscription-id>

サービス プリンシパルの資格情報を含む Kubernetes シークレットを使用します。

# Create secret first
kubectl create secret generic azure-credentials \
  --namespace aks-mcp \
  --from-literal=tenant-id=<your-tenant-id> \
  --from-literal=client-id=<your-client-id> \
  --from-literal=client-secret=<your-client-secret> \
  --from-literal=subscription-id=<your-subscription-id>

# Install with existing secret
helm install aks-mcp . \
  --namespace aks-mcp \
  --set app.accessLevel=readonly \
  --set azure.existingSecret=azure-credentials

Helmの値を介して資格情報を直接渡します（本番環境では推奨されません）。

helm install aks-mcp . \
  --namespace aks-mcp \
  --create-namespace \
  --set azure.tenantId=<your-tenant-id> \
  --set azure.clientId=<your-client-id> \
  --set azure.clientSecret=<your-client-secret>

AKS 拡張機能を使用した VS Code

1. コマンド パレットを開きます (Windows/Linux ではCtrl+Shift+P、macOS ではCmd+Shift+P)。
2. MCP を実行する: サーバーを一覧表示します。
3. 一覧から AKS MCP を選択します。
4. [ サーバーの停止] を選択して、実行中のサーバーを停止します。
5. 構成を削除するには、[ サーバー構成の削除] を選択します。

または、サーバー構成を手動で削除します。

1. .vscode/mcp.json ファイルまたは VS Code ユーザー設定を開きます。
2. aks-mcp-serverまたはservers オブジェクトからgithub.copilot.chat.mcp.serversエントリを削除します。
3. AKS-MCP バイナリをシステムから削除します (場所はインストール方法によって異なります)。

Docker

Docker MCP Toolkit を使用している場合:

1. Docker Desktop を開きます。
2. 左側のサイドバーで MCP Toolkit を選択します。
3. AKS-MCP サーバーを見つけて無効にします。

コンテナー化された構成を使用している場合は、コンテナーを停止して削除します。

docker stop <container-id>
docker rm <container-id>

その他の MCP クライアント

MCP クライアント構成ファイル (Claude Desktop のaksなど) からaks-mcpまたはclaude_desktop_config.jsonエントリを削除します。

Helm リリースを削除する

helm uninstall aks-mcp --namespace aks-mcp

名前空間をクリーンアップする (省略可能)

kubectl delete namespace aks-mcp

Azure リソースのクリーンアップ (ワークロード ID のみ)

ワークロード ID を構成した場合は、関連付けられている Azure リソースを削除します。

# Delete the federated credential
az identity federated-credential delete \
  --name "aks-mcp-federated-credential" \
  --identity-name aks-mcp-identity \
  --resource-group <your-resource-group>

# Remove role assignments
IDENTITY_PRINCIPAL_ID=$(az identity show --resource-group <your-resource-group> --name aks-mcp-identity --query "principalId" -o tsv)
az role assignment delete --assignee $IDENTITY_PRINCIPAL_ID --scope "/subscriptions/<subscription-id>"

# Delete the managed identity
az identity delete --resource-group <your-resource-group> --name aks-mcp-identity

Kubernetes シークレットを削除する (サービス プリンシパルのみ)

サービス プリンシパル資格情報のシークレットを作成した場合:

kubectl delete secret azure-credentials --namespace aks-mcp