mcp-azure

Model Context Protocolサーバーで、Azure（Azure Resource Manager API を介し — Azure Portal の背後にあるプログラム層）を対象とします。MCP対応クライアント（Claude Desktop・Claude Code（Cursor、Codex、…）から Azure リソースを一覧表示・が操作でき、AIaskエージェントを安全な範囲内に保つガバナンス層も備えています。

この機能が提供するもの

• インベントリ — サブスクリプション、リージョン、リソースグループ、リソースを一覧表示します。ARM idで任意のリソースを取得できます。

• オペレーション — 許可されたリージョンでリソースグループを作成し、任意のリソースにタグを統合、VM の電源状態（起動 / 停停止 / 再起動 / 割り当て解除）を制御します。

• ラフサイクル — リソースグループや個々のリソースを、ガード付きで削除します。

• ガバナンス組み込み — アクセスモード、サブスクリプション／リソースグループの許可リスト、保護対象リソースグループ、新規グループ用のリージョン許可リスト、削除のゲーティング、影響の大きい削除に対する型付き確認、ドライラン、JSON 監査ログを備えています。

Related MCP server: Azure MCP Server

ガバナンス & セキュリティモデル

| 対象 | フラグ | 既定値 | 動作 | | -------- | ---- | -- ------------- | ------ | | サーバーはなるできるか？ | AZURE_MODE | read-only | read-only → インベントリ; read-write → リソースグループ作成・タグ付け・VM 電源; admin → 削除。モードを超えるツールは一切登録されません。 | | どの呼びだす? | AZURE_SUBSCRIPTION_ALLOWLIST | *(すべて) | 他のサブスクリプションに対する操作は拒否されます。 | | どのソースグループ? | AZURE_RESOURCE_GROUP_ALLOWLIST | *(all) | リスト外の操作は拒否されます。 | | 恒久読み取り専用グループ | AZURE_PROTECTED_RESOURCE_GROUPS | *(なし) | 読取りのみ可能変更不可されたる。 | | 許可されたリージョン | AZURE_LOCATION_ALLOWLIST | *(任意) | 新しいリソースを作成できるのはここだけです。 | | 削除はできるか？ | AZURE_ALLOW_DELETE | true | 削除にはテンに管理モードが必要です。 | | 型付き確認 | AZURE_REQUIRE_CONIRMATION | true | 削除では confirm がターゲット名と一致する必要があります — 単なるブールではありません。 | | ドライラン | AZURE_DRY_RUN | false | 書込み/管理ツールは検証と要旨のログ記録を行い等、それから戻ります。 | | 監査ロール | AZURE_AUDIT_LOG | true | ガードされた操作ごとの stderr にJSON行を出力します。 |

ツール

読み取り (read-only+): list_subscriptions、list_locations、list_resource_roups、list_resources、get_resource

書取り (read-write+): create_resource_group、tag_resource、control_vm

管理 (admin): delete_resource_group、delete_resource（どちらも AZURE_ALLOW_DELETE + 型指定 confirm が必要）

クイックスタート — エージェントに追加

npm に @dockndevai/mcp-azure として公開されています。npx で Entra ID のサービスプリンシパルを使って実行します。各クライアントの設定は docs/CLIENTS.md、全環境変数は .env.example を参照してください。

Claude Code

claude mcp add azure -e AZURE_TENANT_ID="…" -e AZURE_CLIENT_ID="…" -e AZURE_CLIENT_SECRET="…" -e AZURE_SUBSCRIPTION_ID="…" -e AZURE_MODE="read-only" -- npx -y @dockndevai/mcp-azure

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure"],
      "env": {
        "AZURE_TENANT_ID": "…",
        "AZURE_CLIENT_ID": "…",
        "AZURE_CLIENT_SECRET": "…",
        "AZURE_SUBSCRIPTION_ID": "…",
        "AZURE_MODE": "read-only"
      }
    }
  }
}

プロンプト例

• 「サブスクリプション内のすべてのリソースグループと、それぞれが属するリージョンを一覧表示して」

• 「rg-web グループのすべてのリソースを表示して」

• 「app-plan リソースに env=prod と owner=team-a のタグを付けて」（read-write が必要）

• 「rg-ci の build-agent VM を停止して」（read-write が必要）

ソースコードから実行（開発）

npm install
npm run build
node dist/index.js   # with the environment variables set

開発

npm run dev
npm test          # governance policy: modes, scoping, location allowlist, delete + confirmation
npm run typecheck

公開

公式の MCP レジストリ用に [server.json](serverを、npm の所有者確認用に mcpName を同梱しています。で詳しくは [PUBLISHING.md**。

ライセンス

MIT