Metadata-Version: 2.4
Name: nutanix-mcp
Version: 1.0.1
Summary: Nutanix MCP — Model Context Protocol server for Nutanix Prism Element, Prism Central, and Move
Author: Areen Agrawal
License: MIT License
        
        Copyright (c) 2026 Areen Agrawal
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Repository, https://github.com/veg-salad/nutanix_mcp
Project-URL: Bug Tracker, https://github.com/veg-salad/nutanix_mcp/issues
Keywords: nutanix,prism,mcp,model-context-protocol,ai,copilot
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: System :: Systems Administration
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.3.0
Requires-Dist: requests>=2.31.0
Requires-Dist: urllib3>=2.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: keyrings.alt>=4.0.0
Dynamic: license-file

﻿# Nutanix MCP

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/nutanix-mcp?cacheSeconds=300)](https://pypi.org/project/nutanix-mcp/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)

Ask GitHub Copilot questions about your Nutanix environment in plain English — VMs, hosts, storage, networking, alerts, tasks, protection domains, resource utilization, migration plans, and more — directly from VS Code.

Supports **Prism Element (PE)**, **Prism Central (PC)**, and **Nutanix Move** — with per-cluster, per-PC, and per-Move-appliance credentials stored securely in your OS keyring (Windows Credential Manager / macOS Keychain / Linux Secret Service).

## Requirements

- [Python 3.10+](https://www.python.org/downloads/)
- [VS Code](https://code.visualstudio.com/)
- GitHub Copilot + Copilot Chat extensions

## Quick start

```bash
# 1. Install
pip install nutanix-mcp

# 2. Create a folder for your inventory, navigate to it, and run the wizard
mkdir my-nutanix && cd my-nutanix
nutanix-mcp configure
```

The wizard will:
- Verify Python 3.10+ is active
- Install / update all dependencies
- Register your Prism Element cluster(s), Prism Central instance(s), and Move appliance(s) in `inventory.yaml`
- Store credentials **securely in the OS keyring** — no plain-text passwords anywhere
- Write `.vscode/mcp.json` pointing VS Code at the server (no credentials in this file)

```bash
# 3. Open the folder in VS Code
code .
```

In VS Code, open Copilot Chat, switch to **Agent mode**, and start asking questions.

> **Already set up?** Re-run `nutanix-mcp configure` at any time to add new clusters, PC instances, or Move appliances, and to update credentials.

## Configuration

### Credential storage

Credentials are stored in the OS keyring under the service name `nutanix-mcp`. Key format:

| Entity | Keyring key examples |
|---|---|
| PE cluster (default) | `pe.default.username`, `pe.default.password` |
| PE cluster (override) | `pe.CLUSTER-NAME.username`, `pe.CLUSTER-NAME.password` |
| Prism Central | `pc.PC-NAME.api_key` (preferred) or `pc.PC-NAME.username` / `pc.PC-NAME.password` |
| Move appliance | `move.MOVE-NAME.username`, `move.MOVE-NAME.password` |

Lookup uses named keyring entries and PE default keyring fallback where applicable.

### Cluster inventory — `inventory.yaml`

Register your instances here. Edit directly or re-run `nutanix-mcp configure`.

```yaml
prism_central:
  - name: PROD-PC-1
    pc_host: 192.168.1.50

clusters:
  - name: PROD-CLUSTER-1
    pe_host: 192.168.1.100
  - name: PROD-CLUSTER-2
    pe_host: 192.168.1.200

move_instances:
  - name: PROD-MOVE-1
    move_host: 192.168.1.75
```

- `name` — label used in prompts and tool parameters (`pc_name`, `cluster_name`, `move_name`)
- Single entry → selected automatically; multiple entries → specify the name in your prompt

### VS Code — `.vscode/mcp.json`

Generated by `nutanix-mcp configure`. Contains no credentials:

```json
{
  "servers": {
    "nutanix-mcp": {
      "type": "stdio",
      "command": "nutanix-mcp",
      "env": {
        "NUTANIX_MCP_INVENTORY": "${workspaceFolder}/inventory.yaml"
      }
    }
  }
}
```

## Usage

Switch Copilot Chat to **Agent mode** and ask in plain English:

```
List all VMs and their power state
How much free storage does the cluster have?
Show me any critical alerts
What tasks are currently running?
Show resource utilization for the cluster over the last hour
Get CPU and memory stats for VM <uuid>
Which hosts are in the cluster and what model are they?
List all protection domains
Show migration plans on the Move appliance
Which VMs are currently being seeded?
```

Target a specific cluster, PC instance, or Move appliance by name:

```
List all hosts from cluster PROD-CLUSTER-1
Show VMs on PROD-CLUSTER-2
List all VMs managed by PC PROD-PC-1
Show subnets across all clusters from PROD-PC-1
List migration plans on PROD-MOVE-1
```

Copilot calls `list_inventory` automatically when needed to discover available entries.

## Project structure

```
nutanix-mcp/
├── inventory.yaml              Cluster, PC, and Move registry (user-generated)
├── pyproject.toml              Package metadata and dependencies
├── available_tools.md          Full tool reference
└── src/
    └── nutanix_mcp/
        ├── __init__.py
        ├── app.py              Shared FastMCP instance ("Nutanix MCP")
        ├── cli.py              Entry point — 'nutanix-mcp' and 'nutanix-mcp configure'
        ├── server.py           Thin wrapper delegating to cli.main()
        ├── credentials.py      OS keyring read/write helpers
        ├── registry.py         Inventory loading, host+credential resolvers, JSON helper
        ├── client.py           HTTP clients: pe_get, pc_v4_get, move_get
        └── tools/
            ├── inventory.py            list_inventory
            ├── pe_cluster.py           list_clusters, get_cluster
            ├── pe_hosts.py             list_hosts, get_host
            ├── pe_cvms.py              list_cvms, get_cvm
            ├── pe_vms.py               list_vms, get_vm, get_vm_nics, get_vm_disks
            ├── pe_storage.py           list_storage_containers, get_storage_container,
            │                           list_storage_pools, list_disks, get_disk
            ├── pe_networking.py        list_subnets
            ├── pe_images.py            list_images
            ├── pe_alerts.py            list_alerts, list_events
            ├── pe_ops.py               list_protection_domains, list_tasks
            ├── pe_stats.py             get_vm_stats, get_host_stats,
            │                           get_cluster_stats, get_storage_container_stats
            ├── pc_clusters.py          list_pc_clusters, get_pc_cluster
            ├── pc_vms.py               list_pc_vms, get_pc_vm, list_pc_vm_disks, list_pc_vm_nics
            ├── pc_hosts.py             list_pc_hosts, get_pc_host
            ├── pc_networking.py        list_pc_subnets
            ├── pc_images.py            list_pc_images
            ├── pc_storage.py           list_pc_storage_containers
            ├── pc_alerts.py            list_pc_alerts, get_pc_alert, list_pc_alert_policies
            ├── pc_tasks.py             list_pc_tasks, get_pc_task
            ├── pc_categories.py        list_pc_categories, get_pc_category, list_pc_category_values
            ├── move_environments.py    list_move_environments, get_move_environment,
            │                           list_move_source_environments, list_move_target_environments
            ├── move_plans.py           list_move_plans, get_move_plan, get_move_plan_status
            └── move_vms.py             list_move_workloads, get_move_workload,
                                        list_move_plan_workloads
```

See [available_tools.md](https://github.com/veg-salad/nutanix_mcp/blob/main/available_tools.md) for the full tool reference including parameters, return values, and source modules.

## Notes

- All tools are **read-only** — no changes are made to your Nutanix environment
- PE tools use the Prism Element **v2.0** REST API (per-cluster, port 9440)
- PC tools use the Prism Central **v4.0** REST API (cross-cluster, port 9440); alert listing uses the v2.0 gateway at `/PrismGateway/services/rest/v2.0/alerts`
- Move tools use the Move **v2** REST API (port 443)
- PC tools use `extId` as the entity identifier; use values from `list_*` calls as input to `get_*` calls
- Stats metrics are in **ppm** (parts per million); divide by 10,000 to convert to a percentage
- Transport is **stdio** — the server runs locally and is managed by VS Code

## Security

See [SECURITY_POSTURE.md](https://github.com/veg-salad/nutanix_mcp/blob/main/SECURITY_POSTURE.md) for current security controls, hardening behavior, and operational cautions.

## Disclaimer

This is an independent, community-built project and is **not an official Nutanix product**. It is not affiliated with, endorsed by, or supported by Nutanix, Inc. in any way. Nutanix, Prism, and Move are trademarks of Nutanix, Inc.
