vmware-storage
This server provides VMware vSphere storage management via 11 MCP tools, covering datastores, iSCSI, and vSAN.
Datastore Management
List all datastores with capacity, usage percentage, and accessibility status
Browse datastore files/directories with optional glob pattern filtering (e.g.,
*.iso,*.ova)Scan datastores for deployable images (OVA, ISO, OVF, VMDK)
List locally cached images, filterable by type or datastore
iSCSI Configuration
Enable the software iSCSI adapter on an ESXi host
Get iSCSI adapter status and configured send targets
Add or remove iSCSI send targets (with automatic storage rescan)
Manually rescan all HBAs and VMFS volumes
vSAN Monitoring
Get vSAN cluster health summary and disk group details
Get vSAN capacity overview (total/used/free)
Notes
Most operations are read-only; write operations include input validation and audit logging
Fully supports vSphere 7.0 and 8.0; vSphere 6.7 supported with limited vSAN functionality
Does not support creating, deleting, or modifying virtual machines
Provides tools for managing VMware vSphere storage infrastructure, allowing users to list and browse datastores, manage iSCSI adapters and targets, and monitor vSAN health and capacity across vCenter and ESXi hosts.
VMware Storage
Author: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com This is a community-driven project by a VMware engineer, not an official VMware product. For official VMware developer tools see developer.broadcom.com.
VMware vSphere storage management: datastores, iSCSI, vSAN — 11 MCP tools, domain-focused and lightweight.
Split from vmware-aiops for lighter context and local model compatibility.
Companion Skills
Skill | Scope | Tools | Install |
vmware-aiops ⭐ entry point | VM lifecycle, deployment, guest ops, clusters | 31 |
|
Read-only monitoring, alarms, events, VM info | 8 |
| |
Tanzu Namespaces, TKC cluster lifecycle | 20 |
| |
NSX networking: segments, gateways, NAT, IPAM | 31 |
| |
DFW microsegmentation, security groups, Traceflow | 20 |
| |
Aria Ops metrics, alerts, capacity planning | 18 |
|
Quick Install
# Via PyPI
uv tool install vmware-storage
# Or pip
pip install vmware-storageConfiguration
mkdir -p ~/.vmware-storage
cp config.example.yaml ~/.vmware-storage/config.yaml
# Edit with your vCenter/ESXi credentials
echo "VMWARE_MY_VCENTER_PASSWORD=your_password" > ~/.vmware-storage/.env
chmod 600 ~/.vmware-storage/.env
# Verify
vmware-storage doctorMCP Tools (11)
Category | Tools | Type |
Datastore |
| Read |
iSCSI |
| Read/Write |
vSAN |
| Read |
Common Workflows
Set Up iSCSI Storage on a Host
Enable iSCSI adapter:
vmware-storage iscsi enable esxi-01Add target:
vmware-storage iscsi add-target esxi-01 10.0.0.100Verify:
vmware-storage iscsi status esxi-01
The add-target command automatically rescans storage. Use --dry-run to preview any write command first.
Find Deployable Images Across Datastores
List all datastores:
vmware-storage datastore listScan for images:
vmware-storage datastore scan-images datastore01Browse with a pattern:
vmware-storage datastore browse datastore01 --pattern "*.iso"
vSAN Health Assessment
Check health:
vmware-storage vsan health Cluster-ProdCheck capacity:
vmware-storage vsan capacity Cluster-ProdIf issues found, investigate with
vmware-monitorfor alarms and events
CLI
# Datastore
vmware-storage datastore list
vmware-storage datastore browse datastore01
vmware-storage datastore scan-images datastore01
# iSCSI
vmware-storage iscsi status esxi-01
vmware-storage iscsi enable esxi-01
vmware-storage iscsi add-target esxi-01 192.168.1.100
vmware-storage iscsi remove-target esxi-01 192.168.1.100
vmware-storage iscsi rescan esxi-01
# vSAN
vmware-storage vsan health Cluster-Prod
vmware-storage vsan capacity Cluster-Prod
# Diagnostics
vmware-storage doctorMCP Server
After uv tool install vmware-storage, start the MCP server with one command (v1.5.15+):
# Recommended — single command, no network re-resolve
vmware-storage mcp
# With a custom config path
VMWARE_STORAGE_CONFIG=/path/to/config.yaml vmware-storage mcp
# Or via Docker
docker compose up -dAgent Configuration
Add to your AI agent's MCP config:
{
"mcpServers": {
"vmware-storage": {
"command": "vmware-storage",
"args": ["mcp"],
"env": {
"VMWARE_STORAGE_CONFIG": "~/.vmware-storage/config.yaml"
}
}
}
}# Run without installing (requires PyPI access each launch)
uvx --from vmware-storage vmware-storage mcp
# Legacy entry point (still works, kept for backward compatibility)
vmware-storage-mcpBehind a corporate TLS proxy? uvx may fail with
invalid peer certificate: UnknownIssuer. Use the recommendedvmware-storage mcpform above (no network needed), or setUV_NATIVE_TLS=true.
Why a Separate Skill?
vmware-aiops has 33 MCP tools — too heavy for local LLMs (7B-14B). By splitting storage into its own skill:
11 tools — fits comfortably in small model context windows
Domain-focused — storage admins get only what they need
Composable — use alongside vmware-monitor or vmware-aiops as needed
Version Compatibility
vSphere | Support | Notes |
8.0 | Full | vSAN SDK built into pyVmomi 8.0.3+ |
7.0 | Full | All storage APIs work |
6.7 | Compatible | iSCSI + datastore features work; vSAN limited |
Safety
Feature | Description |
Read-heavy | 6/11 tools are read-only |
Input validation | IP addresses and ports validated before iSCSI operations |
Audit logging | All operations logged to |
No VM operations | Cannot create, delete, or modify VMs |
Credential safety | Passwords only from environment variables, never config files |
Troubleshooting
Problem | Cause & Fix |
iSCSI enable fails with "already enabled" | Not an error — adapter is already active. Run |
"Datastore not found" when browsing | Datastore names are case-sensitive. Run |
vSAN health shows "unknown" | vSAN health requires a vCenter connection, not standalone ESXi. |
Rescan doesn't discover new LUNs | Wait 15-30 seconds after adding targets, then rescan again. Verify target IP is reachable from ESXi. |
"Password not found" error | Variable names follow |
Connection timeout to vCenter | Use |
License
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zw008/VMware-Storage'
If you have feedback or need assistance with the MCP directory API, please join our Discord server