Rancher MCP Server

Model Context Protocol (MCP) server for the **Rancher ecosystem**: multi-cluster Kubernetes, Harvester HCI (VMs, storage, networks), and Fleet GitOps.

Local serverstdioGo

What is the Rancher MCP Server?

Model Context Protocol (MCP) server for the Rancher ecosystem: multi-cluster Kubernetes, Harvester HCI (VMs, storage, networks), and Fleet GitOps.

What it actually does

  • Harvester toolset — List/get VMs, images, volumes, networks, hosts; VM actions; addon list/switch (enable/disable)
  • Kubernetes toolset — List/get/create/patch/delete resources by apiVersion/kind; describe (resource + events), events, capacity
  • Helm toolset — List/get/history of releases; install, upgrade, rollback, uninstall; repo list
  • Fleet toolset — GitRepo list/get/create; Bundle list; Fleet cluster list; drift detection
  • Rancher APIs — Same Bearer token for Steve (/k8s/clusters/...) and Norman (/v3/...); no CLI wrappers
  • Security — Read-only default, disable-destructive, sensitive data masking (Norman token/credential fields redacted unless --show-sensitive-data)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
harvester_vm_listList VMs with status, namespace, spec/status
harvester_vm_getGet one VM (full spec and status)
harvester_vm_actionstart, stop, restart, pause, unpause, migrate
harvester_vm_createCreate VM (when not read-only). Supports network, interface_type (managedtap/bridge/masquerade), subnet for KubeOVN VPC.
harvester_vm_snapshotCreate/list/restore/delete VM snapshots
harvester_vm_backupCreate/list/restore VM backups (Backup Target)
harvester_image_listList VM images (VirtualMachineImage)
harvester_image_createCreate VM image from URL (when not read-only)
harvester_volume_listList PVCs (Longhorn-backed volumes)
harvester_volume_createCreate volume/PVC (optionally from image)
harvester_network_listList VM networks (NetworkAttachmentDefinition)
harvester_network_createCreate VM network - KubeOVN overlay or VLAN (when not read-only)
harvester_network_updateUpdate VM network config (when not read-only)
harvester_network_deleteDelete VM network (when destructive allowed)

How to install the Rancher MCP Server

{
  "mcpServers": {
    "rancher": {
      "command": "npx",
      "args": [
        "-y",
        "rancher-mcp-server",
        "--rancher-server-url",
        "https://rancher.example.com",
        "--rancher-token",
        "token-xxxxx:yyyy",
        "--toolsets",
        "harvester,rancher,kubernetes,fleet"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Rancher to harvester vm list.”
  • “Use Rancher to harvester vm get.”
  • “Use Rancher to harvester vm action.”

Frequently asked questions

Model Context Protocol (MCP) server for the **Rancher ecosystem**: multi-cluster Kubernetes, Harvester HCI (VMs, storage, networks), and Fleet GitOps. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.