What is Mcp Vnc

mcp-vnc is a Model Context Protocol (MCP) Server that allows users to remotely control any desktop using Large Language Models (LLMs) over VNC. It supports various operating systems including Windows, Linux, and MacOS.

Use cases

Use cases for mcp-vnc include IT support teams remotely troubleshooting user issues, educators demonstrating software on students’ machines, and developers testing applications across different operating systems.

How to use

To use mcp-vnc, you need to install Python and the required packages. Download the mcp-vnc.py script and configure it with your Python executable path and VNC server details. Ensure the remote desktop resolution is set to 1024 x 768 for optimal performance.

Key features

Key features of mcp-vnc include compatibility with any VNC server, support for multiple operating systems, and the ability to integrate with LLMs for enhanced remote control capabilities.

Where to use

mcp-vnc can be used in various fields such as remote desktop management, technical support, and educational environments where remote access to desktops is required.

mcp-vnc

Model Context Protocol (MCP) Server to remotely control any desktop using LLMs over VNC.

Supports Windows, Linux and MacOS; basically any VNC server (TightVNC / TigerVNC / RealVNC).
Also, VMware Workstation / Fusion has a built-in VNC server. Under you Virtual Machine’s Settings > Advanced > Remote display over VNC. Enable it, and make sure to set a password. The port should be kept at default, 5900.

As an MCP client, I personally use the Anthropic Claude Desktop Application, with Sonnet/Opus 4 (currently the best model for computer use).
Any MCP-compatible client should work.

DO NOT TRUST ANY LLM TO RUN YOUR PC AUTONOMOUSLY WITHOUT SUPERVISION.

Installation

Python required

This MCP server requires Python (including PIP).

Install the requirements

pip install --upgrade fastmcp pillow vncdotool

Download the MCP server script (mcp-vnc.py)

Download mcp-vnc.py and save it to a permanent location. Use the absolute path for this in the args of your MCP VNC Server (e.g. C:/…/…/mcp-vnc.py or Linux/macOS: /Users/…/…/mcp-vnc.py).

Example claude_desktop_config.json

Can be found in Claude (Desktop App) > Settings > Developer > Edit Config

The path to you python executable can be found using “where python” in the Windows terminal, or “which python” in the terminal on Linux / MacOS.

Don’t forget the double colon (::) instead of the normal single colon (:) in the host parameter.

{
  "mcpServers": {
    "computer": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/PYTHON/EXECUTABLE/ENDING/IN/bin/python",
      "args": [
        "/PATH/TO/YOUR/mcp-vnc.py"
      ],
      "env": {
        "VNC_HOST": "localhost::5900",
        "VNC_PASS": "YOUR VNC PASSWORD"
      }
    }
  }
}

Usage

Make sure to set the screen resolution of your remote desktop to 1024 x 768, this currently works best.