Claude Kvm MCP Server

MCP server — control remote desktops via VNC (MacOS)

Remote serverstreamable-httpGo

What is the Claude Kvm MCP Server?

MCP server — control remote desktops via VNC (MacOS)

What it actually does

Claude KVM is an MCP tool that controls remote desktop environments over VNC. It consists of a thin JS proxy layer (MCP server) and a platform-native Swift VNC daemon running on your macOS system.

Configuration

  • macOS (Apple Silicon / aarch64) - Node.js (LTS)

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
ActionParameters
screenshot
cursor_crop
diff_check
set_baseline
mouse_clickx, y, button?
mouse_double_clickx, y
mouse_movex, y
hoverx, y
nudgedx, dy
mouse_dragx, y, toX, toY
scrollx, y, direction, amount?
key_tapkey
key_combokey or keys
key_typetext
pastetext
detect_elements
configure{reset: true}
get_timing
waitms?
health
shutdown

How to install the Claude Kvm MCP Server

{
  "mcpServers": {
    "claude-kvm": {
      "command": "npx",
      "args": [
        "-y",
        "claude-kvm"
      ],
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_USERNAME": "user",
        "VNC_PASSWORD": "YOUR_VNC_PASSWORD",
        "CLAUDE_KVM_DAEMON_PATH": "/opt/homebrew/bin/claude-kvm-daemon",
        "CLAUDE_KVM_DAEMON_PARAMETERS": "-v"
      }
    }
  }
}

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

Configuration

  • macOS (Apple Silicon / aarch64) - Node.js (LTS)
VariableDescriptionRequired
VNC_HOSTDeclared in the maintainer’s client configuration.Check documentation
VNC_PORTDeclared in the maintainer’s client configuration.Check documentation
VNC_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
VNC_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
CLAUDE_KVM_DAEMON_PATHDeclared in the maintainer’s client configuration.Check documentation
CLAUDE_KVM_DAEMON_PARAMETERSDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Claude Kvm to Layers.”
  • “Use Claude Kvm to Requirements.”
  • “Use Claude Kvm to Daemon.”

Frequently asked questions

MCP server — control remote desktops via VNC (MacOS) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.