Skip to main content
Glama

ESXi MCP

Version 0.3.0 exposes 63 stdio tools for a single standalone ESXi host using the official MCP Python SDK and pyVmomi. It covers VM operations, 14 host-resource controllers, guest operations, complete OVF workflows, background file transfers, durable operation tracking and an optional ESXCLI/shell backend.

中文 · MIT license · Capabilities · Execution guide · Test evidence

Install and configure

Python 3.10+ is required. This project is not published to PyPI:

python -m venv .venv
# Linux/macOS
.venv/bin/python -m pip install -e '.[dev]'
# Windows PowerShell
.venv/Scripts/python.exe -m pip install -e '.[dev]'

Install .[admin] or .[dev,admin] to use the optional ESXi SSH backend. requirements-lock.txt records the earlier Python 3.12 Linux core acceptance environment, excluding the optional SSH dependency; use pyproject resolution for other platforms and extras.

Copy credentials.example.json and config.example.json to a private directory outside the repository. Defaults are ~/.config/esxi-mcp/credentials.json and a sibling config.json. Restrict directory/file permissions to 0700/0600 on Unix and use Windows ACLs. TLS verification is enabled and writes are disabled by default. Set ESXI_CA_FILE for a private CA.

Setting

Meaning

ESXI_CONFIG_FILE, ESXI_DEPLOY_CONFIG_FILE

Private credentials and deployment settings

ESXI_HOST, ESXI_USER, ESXI_PASSWORD, ESXI_PORT

Credential overrides; avoid publishing them

ESXI_ENABLE_WRITES

Explicit ordinary write override; default false

ESXI_ENABLE_ADVANCED_WRITES

Additional API/upload/OVF/SSH write opt-in; default false

ESXI_POLICY_PROFILE

read_only, default operator, or administrator

ESXI_PROTECTED_VM_IDS

Exact comma-separated management VM IDs

ESXI_ALLOW_PROTECTED_IMPACT

Deployment opt-in; a call must also explicitly allow protected impact

ESXI_ALLOW_MANAGEMENT_DISRUPTION

Deployment opt-in; a call must also acknowledge disruption

ESXI_ENABLE_SSH_ADMIN, ESXI_SSH_CREDENTIALS_FILE

Optional ESXi SSH backend and private credentials

ESXI_STATE_DIR

Private SQLite journal and staged transfer files; default beside config

ESXI_LEASE_SESSION_TIMEOUT

Process-local task/lease retention upper bound, default 86400 seconds

ESXI_VERIFY_SSL, ESXI_CA_FILE

TLS validation override or private CA path

ESXI_CONNECT_TIMEOUT, ESXI_AUDIT_FILE

API HTTP timeout (30s default), private audit location

Deployment JSON also supports allowed_operations, denied_operations, protected_datastores and protected_networks. Discover actual management VM IDs first; re-check them after re-registration.

Related MCP server: VMWare MCP

Connect an MCP client

Use the installed virtual environment's Python executable:

{
  "mcpServers": {
    "esxi": {
      "command": "/absolute/path/esxi-mcp/.venv/bin/python",
      "args": ["-m", "esxi_mcp.server"],
      "env": {
        "ESXI_CONFIG_FILE": "/private/path/credentials.json",
        "ESXI_DEPLOY_CONFIG_FILE": "/private/path/config.json"
      }
    }
  }
}

On Windows use the .venv/Scripts/python.exe path. Clients may use their own configuration format. Reload the client after changing configuration. esxi-mcp is an alternative console entrypoint. run-stdio.sh is a portable Unix launcher; remote stdio may use a dedicated SSH key restricted to that launcher. The transport key and optional ESXi administration key are separate credentials.

Control surfaces

Tools

Coverage

17 common VM/host tools

Inventory, health, power, CPU/memory/allocations, creation, rename, snapshots, disk expansion, deletion, tasks

inventory / managers / api_schema / api_get / api_invoke

Typed access to declared, server-supported vSphere methods and properties

14 esxi_*_manage controllers

network, datastore, storage, service, firewall, account, permissions, license, time, pci, certificate, patch, host, options

resource_schema / resource_get / dependencies / capabilities

Named action discovery, exact parameters, current state, conservative impact analysis

operation_status / operation_history

Durable results and reconnectable task tracking

vm_hardware / vm_register

Explicit VirtualDeviceSpec changes and existing VMX registration

guest_process / guest_process_status / guest_files

Authenticated Tools-backed guest process/file workflows

datastore_transfer / api_transfer

Legacy bounded inline datastore/guest/NFC transfer

transfer_start / status / read_chunk / cancel / resume

Bounded-memory background transfer with progress, SHA256 and explicit resume

stage_upload / write_chunk / finalize

Private 1MiB chunk staging, identical-chunk replay and final checksum

ovf_export / ovf_import / execute_plan

Descriptor/disks/manifest/lease workflows and explicit compensated plans

esxcli_query / esxcli / shell

Optional fixed query catalog and explicit administrator commands

Execute

Preview by default; use exact VM ID/name, host address or SDK type/ID as the tool requires. Ordinary mutations require writes; advanced operations additionally require advanced writes. An administrator profile enables host-level administrative operations. Shared changes report dependencies: acknowledge every affected VM. Unknown impact requires explicit administrator acknowledgement. Management-disrupting or protected-impact operations require both deployment and call opt-ins. Default protection remains enforced.

Use esxi_get_task / esxi_operation_status to verify completion. Supported request_id parameters prevent duplicate submissions and return existing results/handles; uncertain requests require inspection. The server never implicitly powers off workloads or deletes snapshots. Guest shutdown does not fall back to power-off. Disk growth does not resize guest filesystems. Plans compensate only explicitly specified completed steps, in reverse order; compensation is not an atomic transaction and is skipped when the failing step has an uncertain result. See resources.

For optional SSH administration, install the extra, configure private ssh.json using ssh.example.json, independently verify a host-key fingerprint (or configure a trusted known_hosts file), and enable the SSH backend. SSH writes are treated as affecting the whole host. Shell payloads and output are omitted from durable logs, retaining argument digests.

Transfer and OVF client

scripts/file_client.py accepts a private stdio transport JSON containing command, args and optional env. Upload/import/export commands preview until --execute is supplied. It streams 1MiB chunks and checks SHA256:

python scripts/file_client.py --transport transport.local.json upload --file installer.iso --datastore DATASTORE --path images/installer.iso --execute
python scripts/file_client.py --transport transport.local.json download --datastore DATASTORE --path images/installer.iso --output copied.iso
python scripts/file_client.py --transport transport.local.json export --vm-id VM_ID --expected-name VM_NAME --output-dir bundle --execute
python scripts/file_client.py --transport transport.local.json import --ovf bundle/vm.ovf --name NEW_VM --datastore DATASTORE --network-map network-map.json --expected-host esxi.example.com --execute

OVF export requires an already powered-off VM. Import accepts an unpacked OVF bundle and explicit network/file mappings, not a raw OVA-as-VMDK upload. fetch --job-id HANDLE --output FILE can resume a local partial download of a completed handle. Remote download resume uses a matching ETag/Last-Modified and exact HTTP Range; uploads restart and require explicit overwrite when needed. Transfer bounds are explicit (up to 64TiB), with private disk space and a 64MiB reserve required; this maximum has not been tested at scale. Staged files remain private until an operator removes them; no automatic retention service is provided.

Test and publish

python -m pytest -q
python scripts/verify_vmomi_contract.py
python -m build

Version 0.3.0 is deployed and passed 121 automatic tests on each of Windows and Linux/Python 3.12, nine offline SDK write checks and four ephemeral loopback SSH integration checks. On an ESXi reporting API 8.0.2.0, it passed 15 disposable-VM checks, eight full-workflow checks (including dedicated network writes, request replay, compensation, 12MiB file transfer and a complete OVF export/import roundtrip), and three real ESXCLI queries. Test resources were removed; the 33 existing VMs and original network configuration matched the run baseline. These checks are not exhaustive compatibility or destructive-operation coverage. See test evidence. GitHub Actions passed all four Ubuntu/Windows and Python 3.10/3.12 combinations (121 tests, SDK contracts, SSH loopback checks and package build in each). See the verified run.

Publish the clean source bundle only. Do not commit private configurations, state databases, staged files, signed URLs, logs or raw acceptance evidence. See SECURITY and CONTRIBUTING.

Coverage follows actual ESXi APIs/commands, licenses, privileges, hardware and state. A schema is not proof of server support. This server does not provide physical BMC/BIOS access, power-on after a physical shutdown or multi-host vCenter orchestration. Guest operations require an OS, running VMware Tools and guest credentials. Background OVF/lease work is process-local and cannot automatically survive an MCP process restart. Only stdio is exposed; use trusted clients. Sources: official MCP SDK v1, pyVmomi.

Available Tools

63 tools
esxi_account_manageB
Destructive

专用 account 管理:create, update, remove, password_change。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_api_getC
Read-onlyIdempotent

读取发现引用的已声明属性;可查询硬件、PCI、VM 设备、网络、存储、服务、账户信息。秘密字段脱敏。

Inputs: target (required), properties (required), depth, max_items. Returns: result

esxi_api_invokeA
Destructive

高级类型化调用:覆盖服务器支持的 vSphere API 管理方法(网络/存储/硬件/服务/账户/guest/主机)。

先 managers/inventory → schema/get → dry_run。真实调用需要写开关、 ESXI_ENABLE_ADVANCED_WRITES=true、expected_target='准确_type:准确_moId'。 非 VM 对象的调用需 allow_disruption=true,可能影响主机/共享资源/管理链路。 直接 VM 引用仍受 protected_vm_ids 限制;共享资源修改须由调用者审查其依赖。 不执行任意 Python 或 shell。异步返回 task_id 后继续查询状态。

Inputs: method (required), target (required), dry_run, arguments, +6 more. Returns: result

esxi_api_schemaB
Read-onlyIdempotent

查看官方 SDK 类型、属性、方法、参数及返回类型。SDK 包含的方法仍可能不被当前 ESXi 支持。

Inputs: type_name (required), depth, method. Returns: result

esxi_api_transferA
Destructive

处理 GuestFileManager 或 HttpNfcLease 返回的 HTTPS URL,完成 guest 文件/OVF-NFC 的 HTTP 阶段。

仅连接当前 ESXi 的 guestFile/NFC 路径。上传默认预览,执行需普通和高级写开关。 lease 传发现的 HttpNfcLease 引用以在下载源文件/上传时刷新进度,最后用 API 调用 Complete/Abort。 OVF 流式 VMDK 通常用 POST 和 application/x-vnd.vmware-streamVmdk;guest 文件用 PUT。 该工具不是一键 OS 安装器;guest 需要 Tools 和认证,OVA 需先取得描述符和独立磁盘数据。

Inputs: operation (required), transfer_url (required), lease, dry_run, +5 more. Returns: result

esxi_capabilitiesC
Read-onlyIdempotent

实际主机版本、许可证、可发现管理器、工具操作目录及部署开关;不把 SDK schema 当作实测支持。

Inputs: no named parameters. Returns: result

esxi_certificate_manageA
Destructive

专用 certificate 管理:csr_create, csr_by_dn, install, ca_replace, notify_services。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_configure_vmB
Destructive

修改 CPU/内存(核数、MHz limit/reservation、MB limit/reservation)。未传字段不变。

Inputs: vm_id (required), expected_name (required), cpu, dry_run, +5 more. Returns: result

esxi_create_snapshotD
Destructive

Inputs: name (required), vm_id (required), expected_name (required), memory, +3 more. Returns: result

esxi_create_vmA
Destructive

创建 VM(明确名称/CPU/内存/磁盘/datastore/network/guest_id,使用正确 resourcePool)。

新建 VM 的 name 就是目标本身,无需额外 expected_name。datastore 和 network 必须 从查询结果中明确指定。创建空 VM,不安装操作系统;不包含 clone/migrate。

Inputs: cpu (required), name (required), disk_gb (required), memory_mb (required), +4 more. Returns: result

esxi_datastore_manageA
Destructive

专用 datastore 管理:nfs_create, vmfs_create, vmfs_expand, vmfs_extend, remove, local_create, vvol_create, swap_update。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_datastore_transferA
Destructive

Datastore 文件 stat/download/upload。可上传 ISO/OVF/VMDK 等文件(不等于部署完成)。

upload 用 base64 或 HTTPS source_url;默认只预览,真实写要求普通和高级写开关。 默认不覆盖,保护管理 VM 目录。URL 上传可流式接收大文件;max_bytes 最大 8GiB。 download 的 base64 响应最多 8MiB。服务端不读取任意本地文件。

Inputs: path (required), datastore (required), operation (required), dry_run, +4 more. Returns: result

esxi_delete_snapshotD
Destructive

Inputs: vm_id (required), snapshot_id (required), expected_name (required), dry_run, +1 more. Returns: result

esxi_delete_vmB
Destructive

删除 VM(必须已关机;dry-run 明示删除磁盘)。

Inputs: vm_id (required), expected_name (required), dry_run. Returns: result

esxi_dependenciesB
Read-onlyIdempotent

VM→网络/存储/文件依赖及管理 VMkernel 连接,供共享资源变更前审查。

Inputs: no named parameters. Returns: result

esxi_esxcliB
Destructive

ESXCLI完整argv入口,用于SDK之外的主机配置/补丁/驱动/存储操作。SSH默认关闭,执行需管理员、独立host-key校验与全部影响确认。

Inputs: arguments (required), dry_run, timeout, expected_host, +4 more. Returns: result

esxi_esxcli_queryC
Read-onlyIdempotent

可选SSH后端的固定只读ESXCLI查询。查询白名单由服务器判断,不接受调用者自报read_only。

Inputs: arguments (required), timeout, max_output_bytes. Returns: result

esxi_execute_planA
Destructive

后台顺序执行明确步骤;每步先预览,异步任务等到成功再下一步。可指定compensate,失败按逆序执行;不承诺原子回滚、不自动重试。

Inputs: steps (required), dry_run, request_id, timeout_per_step, +1 more. Returns: result

esxi_expand_diskC
Destructive

仅允许增长,由 device_key 精确定位;有快照时拒绝。

Inputs: vm_id (required), device_key (required), new_size_gb (required), expected_name (required), +1 more. Returns: result

esxi_firewall_manageB
Destructive

专用 firewall 管理:enable, disable, rules_update, default_policy。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_get_taskB
Read-onlyIdempotent

查询异步任务状态:queued/running/success/error。

Inputs: task_id (required). Returns: result

esxi_get_vmC
Read-onlyIdempotent

按 vm_id(MoRef)查询单台 VM 详情。

Inputs: vm_id (required). Returns: result

esxi_guest_filesB
Destructive

Guest 文件list/mkdir/delete/move/attributes/upload_url/download_url。HTTP传输用后台transfer_start(kind=guest),大文件不经LLM传整个base64。

Inputs: vm_id (required), action (required), arguments (required), expected_name (required), +3 more. Returns: result

esxi_guest_processA
Destructive

Guest 进程start/terminate:显式OS内路径和认证;start返回PID,再process_status查看exitCode。不会自动用ESXi shell替代guest。

Inputs: vm_id (required), action (required), expected_name (required), authentication (required), +7 more. Returns: result

esxi_guest_process_statusB
Read-onlyIdempotent

查询guest进程状态、PID、启动/结束时间与exitCode;只读,可检查受保护VM。

Inputs: vm_id (required), expected_name (required), authentication (required), pids. Returns: result

esxi_healthA
Read-onlyIdempotent

ESXi 主机整体健康状态(连接态/维护模式/overallStatus/uptime/quickStats 即时负载)。

Inputs: no named parameters. Returns: result

esxi_host_manageA
Destructive

专用 host 管理:maintenance_enter, maintenance_exit, reboot, shutdown, lockdown_enter, lockdown_exit, disconnect, reconnect。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_host_summaryB
Read-onlyIdempotent

主机容量摘要。quickstats_* 为物理已用量;VM 配置内存总和另列,勿混淆。

Inputs: no named parameters. Returns: result

esxi_inventoryC
Read-onlyIdempotent

列出 SDK 管理实体的准确类型/ID/名称:VM、HostSystem、Datastore、Network、Folder、ResourcePool。

Inputs: limit, resource_type. Returns: result

esxi_license_manageA
Destructive

专用 license 管理:add, remove, update, labels_update。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_list_datastoresD
Read-onlyIdempotent

Inputs: no named parameters. Returns: result

esxi_list_networksD
Read-onlyIdempotent

Inputs: no named parameters. Returns: result

esxi_list_snapshotsB
Read-onlyIdempotent

递归列出指定 VM 的快照树,输出 snapshot_id。

Inputs: vm_id (required). Returns: result

esxi_list_vmsA
Read-onlyIdempotent

列出所有 VM(可按名称/IP 过滤)。内存字段为配置值,非物理内存占用。

Inputs: ip_filter, name_filter. Returns: result

esxi_managersB
Read-onlyIdempotent

发现服务与 HostConfigManager 的网络、存储、服务、防火墙、账户、硬件等管理器引用。

Inputs: no named parameters. Returns: result

esxi_network_manageA
Destructive

专用 network 管理:switch_create, switch_update, switch_remove, portgroup_create, portgroup_update, portgroup_remove, vmkernel_create, vmkernel_update, vmkernel_remove, dns_update, route_update, routes_update, physical_link_update, configuration_update。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_operation_historyB
Read-onlyIdempotent

查询当前主机/账户的持久化操作清单;不会输出密码或 signed URL。

Inputs: limit. Returns: result

esxi_operation_statusB
Read-onlyIdempotent

持久化操作记录:submitted 任务可重新连接查询;中断的 executing 操作不自动重复。

Inputs: operation_id (required), refresh_task. Returns: result

esxi_options_manageB
Destructive

专用 options 管理:update。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_ovf_exportA
Destructive

完整OVF导出:VM须已关机,后台导出磁盘、生成OVF与SHA256 manifest,并Complete/Abort租约。operation_status查询,transfer_read_chunk取回files句柄。

Inputs: vm_id (required), expected_name (required), dry_run, request_id, +1 more. Returns: result

esxi_ovf_importA
Destructive

完整OVF导入:验证描述符/网络/数据存储/文件映射,后台NFC上传、完成租约;失败Abort,不删除已有VM。disks按OVF文件path映射source_job_id或HTTPS source_url。

Inputs: name (required), disks (required), datastore (required), ovf_descriptor (required), +8 more. Returns: result

esxi_patch_manageA
Destructive

专用 patch 管理:check, scan, stage, install, uninstall, query。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_pci_manageA
Destructive

专用 pci 管理:configuration_update, refresh。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_permissions_manageB
Destructive

专用 permissions 管理:role_create, role_update, role_remove, permission_set, permission_remove。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_power_vmA
Destructive

电源操作:power_on / shutdown(优雅,需Tools) / power_off / reboot_guest(需Tools) / reset。

Inputs: vm_id (required), operation (required), expected_name (required), dry_run. Returns: result

esxi_rename_vmD
Destructive

Inputs: vm_id (required), new_name (required), expected_name (required), dry_run. Returns: result

esxi_resource_getC
Read-onlyIdempotent

按资源域直接查询状态,无需手工拼管理器 ID;只允许已声明属性。

Inputs: domain (required), properties (required), depth, max_items. Returns: result

esxi_resource_schemaC
Read-onlyIdempotent

专用资源操作目录和准确参数:network/datastore/storage/service/firewall/account/permissions/license/time/pci/certificate/patch/host。

Inputs: domain (required), depth, action. Returns: result

esxi_revert_snapshotD
Destructive

Inputs: vm_id (required), snapshot_id (required), expected_name (required), dry_run. Returns: result

esxi_service_manageA
Destructive

专用 service 管理:start, stop, restart, startup_policy。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_shellB
Destructive

显式整台ESXi shell管理入口,仅administrator+SSH独立开关+管理链路/保护影响双重允许。任意shell无法做完整依赖推断,不自动重试。

Inputs: command (required), dry_run, timeout, expected_host, +4 more. Returns: result

esxi_stage_finalizeC
Destructive

核对完整字节数及SHA256,完成暂存后可作为transfer_start的source_job_id。

Inputs: job_id (required), dry_run. Returns: result

esxi_stage_uploadB
Destructive

创建私有大文件暂存句柄;客户端随后write_chunk并finalize,不接收任意服务器本地路径。

Inputs: filename (required), total_bytes (required), dry_run, expected_sha256. Returns: result

esxi_stage_write_chunkC
Destructive

追加<=1MiB块;相同offset/内容的重试幂等,拒绝空洞或覆盖不同内容。

Inputs: job_id (required), offset (required), data_base64 (required), dry_run. Returns: result

esxi_storage_manageB
Destructive

专用 storage 管理:rescan, rescan_vmfs, vmfs_format, partition_update, vmfs_mount, vmfs_unmount, lun_attach, lun_detach, iscsi_enable, iscsi_discovery, iscsi_authentication, iscsi_send_targets_add, iscsi_send_targets_remove, multipath_policy, nvme_connect, nvme_disconnect。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_time_manageB
Destructive

专用 time 管理:configuration_update, clock_update。先 resource_schema/get 和默认预览;实际执行精确 expected_host、写开关与依赖确认,支持 request_id 防止重复执行。

Inputs: action (required), dry_run, arguments, request_id, +5 more. Returns: result

esxi_transfer_cancelA
Destructive

请求停止后台传输,保留部分数据;不会自动删除/覆盖远端文件。

Inputs: job_id (required), dry_run. Returns: result

esxi_transfer_read_chunkA
Read-onlyIdempotent

读取已完成的下载/暂存文件;每块最多1MiB,用offset拼接并核对最终SHA256。

Inputs: job_id (required), length, offset. Returns: result

esxi_transfer_resumeA
Destructive

显式恢复失败/取消/中断传输。下载验证ETag/Last-Modified与Range;上传重新发送,远端已有文件需明确overwrite。NFC需原租约仍活着。

Inputs: job_id (required), dry_run, overwrite. Returns: result

esxi_transfer_startA
Destructive

后台流式 datastore/guest/NFC 下载或上传(最多64TiB显式上限,受暂存磁盘空间约束)。立即返回 job_id,status 查询,read_chunk 分块取回。

Inputs: kind (required), operation (required), path, lease, +11 more. Returns: result

esxi_transfer_statusB
Read-onlyIdempotent

传输/暂存进度、字节数、校验和、错误;不输出 signed URL 或服务器任意路径。

Inputs: job_id (required). Returns: result

esxi_vm_hardwareC
Destructive

增删/编辑虚拟磁盘、网卡、光驱、控制器、PCI 设备。device_changes 使用官方 VirtualDeviceSpec,保留其余 VM 配置。

Inputs: vm_id (required), expected_name (required), device_changes (required), dry_run, +1 more. Returns: result

esxi_vm_registerB
Destructive

将已有 VMX 注册到该 ESXi 的 VM 文件夹与资源池;不创建或覆盖 VM 文件。

Inputs: name (required), vmx_path (required), datastore (required), dry_run, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 63 tools

    Disambiguation3/5

    Most tools are named for a distinct domain (firewall, license, time, snapshots), but there is real overlap between the generic catch-alls (esxi_api_get, esxi_api_invoke, esxi_resource_get) and the specialized *_manage tools, plus four or more file-transfer paths (datastore_transfer, api_transfer, transfer_start/stage_upload, guest_files upload_url/download_url). Descriptions provide guidance ('managers/inventory → schema/get → dry_run'), which helps, but an agent can still reasonably misselect between the generic and domain-specific layers.

    Naming Consistency3/5

    All names share the esxi_ prefix and snake_case, but the verb/noun ordering is inconsistent: verb_noun (esxi_list_vms, esxi_create_snapshot), noun_verb (esxi_transfer_start, esxi_stage_upload), noun-only (esxi_inventory, esxi_capabilities, esxi_managers), and bare verbs (esxi_shell, esxi_esxcli). Readable overall, but the mixed conventions reduce predictability.

    Tool Count2/5

    63 tools is far above the practical range for reliable tool selection, and several clusters (transfer, API access, plans) could be consolidated. The breadth of ESXi management justifies many tools, but the count still creates a heavy selection surface with substantial redundancy.

    Completeness5/5

    The surface covers VM lifecycle (create/configure/power/delete/register/hardware), snapshots, datastores, networks, storage, services, firewall, accounts, permissions, license, time, PCI, certificates, patching, guest processes/files, OVF import/export, and raw esxcli/shell access. Only niche operations like VM clone/migrate are explicitly excluded, so coverage is effectively complete for standalone ESXi management.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to manage VMware vSphere infrastructure through 55 typed tools built on the govc CLI. It supports comprehensive operations including VM lifecycle management, snapshot control, datastore navigation, and networking configuration.
      5
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI-assisted management of vCenter Server and standalone ESXi hosts, including lifecycle, deployment, guest operations, cluster management, datastore browsing, alarms, and investigations through natural language.
      60
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants such as Claude, Gemini, and GPT to connect directly to VMware ESXi and vCenter hosts over stdio JSON-RPC. Provides full virtual machine lifecycle management (create, clone, delete, power on/off) plus real-time CPU, memory, storage, and network performance monitoring, with API key authentication and SSL/TLS support.
      MIT