Nutanix AIops

Nutanix AIops

免責事項：コミュニティが保守するオープンソースプロジェクトです。**Nutanix との提携、承認、または後援を受けていません。**製品名および商標名は各権利者に帰属します。MIT ライセンスの下で提供されています。

Nutanix Prism Central（v4 REST API）向けのガバナンス対応 AI 運用機能です。クラスター、ホスト、VM（AHV + ESXi）、ストレージ、ネットワーク、カタログ、データ保護／DR、アラート、LCM アップグレード、容量を対象とし、組み込みのガバナンス機能（統合監査ログ、トークン／暴走防止予算ガード、取り消しトークンの記録、説明的なリスクティアラベル）を備えています。HTTPS :9440 で HTTP Basic 認証（ユーザー名 + 暗号化されたパスワード）を使用して Prism Central に接続します。自己完結型で、依存関係は httpx と MCP SDK のみです。

読み取り専用の Nutanix MCP ではなく、これを選ぶ理由

• すべての変更操作に対する ETag / If-Match の自動処理。v4 API では、対象エンティティの現在の ETag がないと更新や削除が拒否されます。これはよくある落とし穴です。このツールが ETag を取得し、If-Match を送信します。
• 自動ページネーション — リストツールは v4 のすべてのページを自動でたどります。また、{"<items>": [...], "returned", "limit", "truncated"} という形式で返すため、上限に達した読み取りはそのことが明示され、環境全体を取得したかのように見えることはありません。
• 存在しないことは、空であることではありません — Prism Central が返さなかったフィールドは "" ではなく、null として返されます。v4 では多くのフィールドが省略されますが、この 2 つの状態は区別されます。
• 複数のハイパーバイザーに対応した VM 一覧表示 — vm_list は同じ Prism Central 配下の AHV と ESXi の両方のゲストを返します（ハイパーバイザー移行中の環境向けに設計されています）。
• ガバナンス機能 — 監査／トークンと呼び出しの予算／説明的なリスクティアラベル／取り消しトークン／プロンプトインジェクションのサニタイズを備え、破壊的な書き込みには ドライラン + 二重確認 を適用します。

このツールが判断すること、しないこと

このツールは Nutanix Prism Central の操作（読み取りと書き込み）を正確かつ効率的に実行し、そのすべてを記録します。書き込みを許可するかどうかを判断することはありません。それはエージェントの判断、または接続に使用するアカウントの権限に委ねられます。読み取り専用の（Viewer）ロールだけを持つ Prism Central アカウントで接続すれば、書き込みはサーバー側で拒否されます。実際に権限を管理しているのはサーバーです。

そのため、読み取り専用スイッチも、ポリシーファイルも、設定が必要な承認ゲートもありません。このツールが保証するのは、何も黙って実行されないことです。MCP 経由でも CLI 経由でも、すべての呼び出しは ~/.nutanix-aiops/audit.db に監査行として記録され、破壊的な書き込みでは引き続き変更前の状態が取得され、逆操作が存在する場合は記録されます。

各ツールは risk_level を宣言し、説明用のティア（none/confirm/review）として監査行に記録します。これにより、レビュー担当者は高リスクの削除を示す行をひと目で確認できます。これはラベルであり、ゲートではありません。

より小規模なモデルやローカルモデルを実行していますか？agent-guardrails.md を参照してください。このツールが現在適用しているガードレール（プロンプトの予算を使って繰り返し指定する必要はありません）と、残りの部分に使えるすぐに利用可能なシステムプロンプトを記載しています。

機能マトリクス（MCP ツール 51 個）

グループ	ツール	数	読み取り／書き込み
クラスター	cluster_list, cluster_health, host_list, cluster_utilization	4	読み取り 4
VM	vm_list, vm_get, vm_power_on, vm_guest_shutdown, vm_power_off, vm_reboot, vm_create, vm_update, vm_clone, vm_delete, vm_migrate	11	読み取り 2 · 書き込み 9
ストレージ	storage_container_list / _create / _update / _delete	4	読み取り 1 · 書き込み 3
ネットワーク	subnet_list, subnet_get, subnet_create, subnet_delete	4	読み取り 2 · 書き込み 2
カタログ	image_list, image_delete, category_list, category_create, category_assign	5	読み取り 2 · 書き込み 3
データ保護／DR	snapshot_list / _create / _delete / _restore, recovery_point_list, protection_domain_list, vm_protect, pd_failover	8	読み取り 3 · 書き込み 5
アラート	alert_list, event_list, audit_list, analyze_alert（RCA）, alert_acknowledge, alert_resolve	6	読み取り 4 · 書き込み 2
LCM（アップグレード）	lcm_inventory, lcm_precheck, lcm_update	3	読み取り 1 · 書き込み 2
容量	task_list, capacity_runway	2	読み取り 2
診断／RCA	cluster_health_rca, alert_triage_rca	2	読み取り 2
取り消し	undo_list, undo_apply	2	読み取り 1 · 書き込み 1
合計		51	読み取り 24 · 書き込み 27

診断／RCAは、主力の読み取り機能です。cluster_health_rcaは環境全体を評価し、耐障害性の低下、80%（警告）／90%（重大）を超えるストレージプールとコンテナー、正常でないノードやインベントリーに存在しないノードを、深刻度の高い順に表示します。それぞれの検出結果には、該当するしきい値を超えた測定割合または Prism の生の状態が示されます。alert_triage_rcaは、アクティブなアラートを重大度別にグループ化し、各レベルの件数を表示するとともに、未確認の重大アラートにフラグを付け、未解決のアラートのうち最も古いものとその経過時間を示します。いずれも読み取り専用（risk_level="low"）で決定的です。時計や乱数に依存せず、同じ入力には同じ結果を返します。analyze_alertは単一のアラートを対象にこれらの機能を補完し、アラートと関連イベントを相関させて、推定される原因と推奨アクションの要約を作成します。リスクの高い書き込み操作（vm_delete、vm_migrate、storage_container_delete、subnet_delete、snapshot_delete、snapshot_restore、pd_failover、image_delete、lcm_update）は、dry_runと、CLIでの二重確認に対応しています。

インストール

uv tool install nutanix-aiops          # or: pipx install nutanix-aiops

クイックスタート

Claude Code プラグインとして

1 回のインストールで、エージェントにスキルとMCP サーバーの両方が導入されます。

/plugin marketplace add AIops-tools/marketplace
/plugin install nutanix-aiops@aiops-tools

MCP サーバーはuvで取得され、このプラグインが宣言するパッケージバージョンに固定されます。そのため、監査記録から、それを書き込んだコードを追跡できます。認証情報は引き続きnutanix-aiops initで設定します。詳しくは以下を参照してください。

OpenClaw プラグインとして

同じバンドルがClawHubで公開されており、1 回のインストールでスキルとMCP サーバーが一緒に導入されます。

openclaw plugins install clawhub:@zw008/nutanix-aiops
openclaw skills info nutanix-aiops          # expect: Visible to model: yes

その後、プラグインを読み込むためにOpenClawゲートウェイを再起動してください。MCP サーバーはuvで取得され、このリリースの正確なバージョンに固定されます。そのため、uvxがPATH上にある必要があります。ない場合、スキルはインストールされますが、Visible to model: noと表示されます。認証情報は以下と同じ方法で設定します。

CLIまたはスタンドアロンのMCP サーバーとして

nutanix-aiops init                     # wizard: PC host / port 9440 / username / verify_ssl + encrypted password
nutanix-aiops doctor                   # config, secrets, connectivity + REST-RBAC preflight
nutanix-aiops overview                 # one-shot estate summary
nutanix-aiops diagnose cluster-health  # worst-first RCA: resiliency, storage, nodes
nutanix-aiops vm list                  # AHV + ESXi VMs

MCP サーバーとして実行する場合（stdio）：

export NUTANIX_AIOPS_MASTER_PASSWORD=...   # unlock the encrypted secret store non-interactively
nutanix-aiops mcp

パスワードの保存場所について：環境変数としてエクスポートした値は、このシェルが起動するすべてのプロセスから読み取り可能で、シェルの履歴にも記録されます。共有ホストや長時間稼働するホストでは、対話型プロンプトを使用するか、必要な1つのコマンドの実行中だけシークレットマネージャーから注入する方法をおすすめします。

CLI

nutanix-aiops（Typer）：init、overview、doctor、mcp；cluster list/health/hosts/util；vm list/get/power/delete/migrate（delete と migrate では --dry-run と二重確認を使用）；diagnose cluster-health、diagnose alert-triage；secret set/list/rm/migrate/rotate-password。 CLI は利便性を重視したサブセットです。全 51 ツールの機能は MCP サーバーから利用できます。

ガバナンス

すべての MCP ツールは、同梱の @governed_tool ハーネスを通過します。

• 監査 — すべての呼び出し（パラメーター、結果、ステータス、所要時間、リスクティア、オペレーターが指定した承認者／理由）は、~/.nutanix-aiops/audit.db（NUTANIX_AIOPS_HOME で移動可能）に記録されます。CLI は MCP 経由と同じ行を書き込むため、監査されないエントリーポイントはありません。
• 暴走防止ガード — 認可ゲートではなく、安全対策です。同じ呼び出しを短時間に繰り返すと、サーキットブレーカーが作動します。NUTANIX_RUNAWAY_MAX=0 で無効にできます。必要に応じて NUTANIX_MAX_TOOL_CALLS／NUTANIX_MAX_TOOL_SECONDS で上限を設定できます。
• 取り消しの記録 — 元に戻せる書き込みでは、取得した変更前の状態に基づいて逆操作の記述子を記録します（vm_update → 変更前の CPU／メモリー、vm_migrate → 変更前のホスト）。
• リスクティア — risk_level から導出される、監査行に付与される説明用ラベルです。何かを制限するものではありません。

認証情報

Prism Central のパスワードは ~/.nutanix-aiops/secrets.enc に暗号化して保存されます（Fernet + scrypt）。ディスク上に平文で保存されることはありません。 NUTANIX_AIOPS_MASTER_PASSWORD（MCP／CI）から取得したマスターパスワード、または対話形式のプロンプト（CLI）でロックを解除します。機密情報ではない接続詳細（ホスト、ポート、ユーザー名、verify_ssl）は ~/.nutanix-aiops/config.yaml に保存されます。従来の平文環境変数 NUTANIX_<TARGET>_PASSWORD はフォールバックとして使用されます。

注意点： Prism Central アカウントには、Web UI へのアクセス権限だけでなく、REST API の権限が必要です。doctor の REST-RBAC 事前チェックで早期に検出できます。

対応範囲と制限事項

• 検証状況。 現在、すべての動作はモックの v4 REST レスポンスに対して検証されています。実際の Prism Central に対する実行はまだ行われていません。実環境で最も手早く確認するには、nutanix-aiops doctor を実行してください。実環境での検証チェックリスト全体については、docs/VERIFICATION.md を参照してください。
• Nutanix Community Edition（CE）で無料でセルフテスト可能： 単一ノードの CE クラスターと X-Small Prism Central VM。
• 検証が最も不十分なパス： LCM 更新（lcm_update）、保護ドメインのフェイルオーバー（pd_failover）、特にESXi VM の一覧表示には、実環境での検証が必要です。
• 今回のリリースの対象外： IAM／ユーザー／ロール、Files／Objects／Volumes サービス、レポート、X-Play プレイブック、Prism Central v4 の対象外すべて。

必要な機能がありませんか？

ツール、API の方言、またはワークフローが不足していますか？Issue または PR を作成してください。フィードバックや貢献を歓迎します。