Claude KVM MCP Server

Name: Claude KVM MCP Server
Author: io.github.ARAS-Workspace

io.github.ARAS-Workspace/claude-kvm

Repository Registry

What is the Claude KVM MCP server?

MCP server — control remote desktops via VNC with a native Swift daemon and Apple Vision OCR

How to install Claude KVM

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

VNC_HOST
required
VNC server hostname or IP
VNC_PORT
required
VNC server port
VNC_USERNAME
secret
VNC/ARD username
VNC_PASSWORD
secret
VNC/ARD password
CLAUDE_KVM_DAEMON_PATH
required
Path to claude-kvm-daemon binary

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "claude-kvm": {
      "command": "npx",
      "args": [
        "-y",
        "claude-kvm"
      ],
      "env": {
        "VNC_HOST": "<YOUR_VNC_HOST>",
        "VNC_PORT": "<YOUR_VNC_PORT>",
        "VNC_USERNAME": "<YOUR_VNC_USERNAME>",
        "VNC_PASSWORD": "<YOUR_VNC_PASSWORD>",
        "CLAUDE_KVM_DAEMON_PATH": "<YOUR_CLAUDE_KVM_DAEMON_PATH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "claude-kvm": {
      "command": "npx",
      "args": [
        "-y",
        "claude-kvm"
      ],
      "env": {
        "VNC_HOST": "<YOUR_VNC_HOST>",
        "VNC_PORT": "<YOUR_VNC_PORT>",
        "VNC_USERNAME": "<YOUR_VNC_USERNAME>",
        "VNC_PASSWORD": "<YOUR_VNC_PASSWORD>",
        "CLAUDE_KVM_DAEMON_PATH": "<YOUR_CLAUDE_KVM_DAEMON_PATH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-kvm": {
      "command": "npx",
      "args": [
        "-y",
        "claude-kvm"
      ],
      "env": {
        "VNC_HOST": "<YOUR_VNC_HOST>",
        "VNC_PORT": "<YOUR_VNC_PORT>",
        "VNC_USERNAME": "<YOUR_VNC_USERNAME>",
        "VNC_PASSWORD": "<YOUR_VNC_PASSWORD>",
        "CLAUDE_KVM_DAEMON_PATH": "<YOUR_CLAUDE_KVM_DAEMON_PATH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "claude-kvm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-kvm"
      ],
      "env": {
        "VNC_HOST": "<YOUR_VNC_HOST>",
        "VNC_PORT": "<YOUR_VNC_PORT>",
        "VNC_USERNAME": "<YOUR_VNC_USERNAME>",
        "VNC_PASSWORD": "<YOUR_VNC_PASSWORD>",
        "CLAUDE_KVM_DAEMON_PATH": "<YOUR_CLAUDE_KVM_DAEMON_PATH>"
      }
    }
  }
}

Claude Code

claude mcp add claude-kvm --env VNC_HOST=<YOUR_VNC_HOST> --env VNC_PORT=<YOUR_VNC_PORT> --env VNC_USERNAME=<YOUR_VNC_USERNAME> --env VNC_PASSWORD=<YOUR_VNC_PASSWORD> --env CLAUDE_KVM_DAEMON_PATH=<YOUR_CLAUDE_KVM_DAEMON_PATH> -- npx -y claude-kvm