kubectl-mtv MCP Server

A Model Context Protocol (MCP) server that gives AI assistants the ability to manage Migration Toolkit for Virtualization (MTV) operations.

What is it?

An MCP server that wraps kubectl-mtv commands, allowing AI assistants like Claude and Cursor to help you with VM migration tasks.

What does it do?

• Query MTV resources (providers, plans, VMs, mappings)
• Monitor migration status and logs
• Create and manage migration plans
• Configure providers, networks, and storage mappings
• Control migration lifecycle (start, cancel, cutover)

Available Tools

The MCP server provides three tools for AI assistants:

Tool	Description
mtv_read	Read-only operations: get/describe providers, plans, mappings, inventory
mtv_write	Write operations: create/delete/patch providers, plans, mappings
kubectl_debug	Debug migrations using kubectl: get pods, logs, events

Transparency

When AI assistants use these tools, they show you the exact kubectl commands being executed, so you can:

• Learn the underlying CLI commands
• Verify what operations are being performed
• Run the same commands manually if needed

Recommended Installation

The recommended way to use this MCP server is through the kubectl-mtv CLI tool, which integrates this server and provides a convenient interface.

Quick Setup

For Claude Desktop:

claude mcp add kubectl-mtv kubectl mtv mcp-server

For Cursor IDE:

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "kubectl-mtv": {
      "command": "kubectl",
      "args": ["mtv", "mcp-server"]
    }
  }
}

Why Use kubectl-mtv CLI?

• Single Installation: Get kubectl-mtv and the MCP server together
• Always Up-to-Date: MCP server updates come with kubectl-mtv releases
• Better Integration: Seamless access to all kubectl-mtv functionality
• Easier Setup: No need to install a separate binary

Documentation

For complete setup and usage instructions, see the kubectl-mtv MCP Server Guide.

Example Interactions

Once configured, you can ask your AI assistant things like:

• "What providers and plans do I have in my cluster?"
• "Show me the VMs available in the vsphere-prod provider"
• "Create a new migration plan for vm-web-01"
• "What's the status of my running migrations?"
• "Check the controller logs for any warnings"

The assistant will execute the appropriate kubectl-mtv commands and show you the results.

About kubectl-mtv

kubectl-mtv is a kubectl plugin for migrating virtual machines to KubeVirt using Forklift. The MCP server integration enables AI assistants to help with all kubectl-mtv operations.

Prerequisites

• kubectl-mtv installed and in your PATH
• Access to a Kubernetes cluster with MTV deployed
• Appropriate cluster permissions

Advanced: Standalone Usage

While using the kubectl-mtv CLI is recommended, this server can also be built and run standalone for development purposes. See the documentation in the docs directory for details.

License

Apache License 2.0