sk3tch/glkvm-mcp

GLKVM MCP Server

A Python MCP server for controlling KVM devices directly over HTTPS with mutual TLS (client certificate) authentication. This allows Claude and other agents to drive GUIs on other computers. This opens up being able to drive GUIs on places where Claude isn't installed, or can't be installed. For example, if you wanted to have Claude help you automate an OS install or BIOS configuration, you could do that. There's of course the question of should you do that. As a security person it was somewhat terrifying to see how easy this was to build and how well it works.

Features

• Direct connection - No proxy server, connects directly to KVM devices
• mTLS authentication - Client certificates for secure access
• 10 MCP tools - Screenshot, mouse, keyboard, OCR, device management
• Local OCR - Tesseract runs locally, no cloud APIs needed
• Simple setup - One script to provision new KVM devices

Prerequisites

Local Machine (where MCP server runs)

• Python 3.10+
• Tesseract OCR: apt install tesseract-ocr or brew install tesseract
• ffmpeg: apt install ffmpeg or brew install ffmpeg

KVM Device

• Linux with USB HID gadget support (GL.iNet, Raspberry Pi, etc.)
• ustreamer running for video capture
• Python 3

Installation

# Clone the repository
git clone https://github.com/sk3tch/glkvm-mcp.git
cd glkvm-mcp

# Install Python dependencies
pip install -r requirements.txt

# Generate certificates (one-time)
./scripts/generate_certs.sh

KVM Device Setup

On each KVM device:

curl -sSL https://raw.githubusercontent.com/sk3tch/glkvm-mcp/main/scripts/setup_kvm.sh | sudo bash

The script will:

1. Ask for a device ID
2. Ask for your CA certificate
3. Generate a server certificate (you'll sign it with your CA)
4. Install and start the HID server

Configuration

Create ~/.config/glkvm-mcp/config.yaml:

devices:
  kvm-office:
    ip: 192.168.1.31
    name: "Office PC"

  kvm-server:
    ip: 192.168.1.32
    name: "Home Server"

Usage with Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "glkvm": {
      "command": "python",
      "args": ["-m", "glkvm_mcp.server"],
      "cwd": "/path/to/glkvm-mcp/src"
    }
  }
}

Or if installed as a package:

{
  "mcpServers": {
    "glkvm": {
      "command": "glkvm-mcp"
    }
  }
}

Available Tools

License

MIT