mcvnc

VNC client as an MCP server. Gives language models interactive access to remote desktops -- connect to VNC sessions, capture screenshots, send keyboard and mouse input, read and write the clipboard.

Built on FastMCP and asyncvnc2.

Install

pip install mcvnc

Or with uv:

uv tool install mcvnc

Quickstart

Claude Code

claude mcp add mcvnc -- uvx mcvnc

Other MCP hosts (stdio transport)

{
  "mcpServers": {
    "mcvnc": {
      "command": "uvx",
      "args": ["mcvnc"]
    }
  }
}

Manual / development

git clone https://git.supported.systems/warehack.ing/mcvnc.git
cd mcvnc
make install  # uv sync --group dev
make run      # uv run mcvnc

Tools

Connection

Screen

Input

Clipboard

Typical workflow

vnc_connect  ->  vnc_screenshot  ->  interpret UI  ->  interact
                      ^                                    |
                      |                                    v
                      +----  vnc_screenshot  <----  vnc_wait_for_screen_change

Use vnc_screenshot_region when you only care about a dialog, menu, or status bar -- it requests just that rectangle from the VNC server instead of the full desktop.

Use vnc_wait_for_screen_change after interactions to wait for the UI to actually update before taking the next screenshot. Optionally pass a region to watch for changes only within that area.

Configuration

All settings via environment variables, all optional:

Development

make install   # uv sync --group dev
make test      # pytest
make lint      # ruff check

License

GPL-3.0-or-later -- required by the asyncvnc2 dependency.