Mcp Vnc

Mcp Vnc is an MCP server that enables AI agents to connect to and remotely control machines running a VNC server. Built for developers, system administrators, and automation engineers, it bridges Model Context Protocol clients like Claude Desktop with remote desktop sessions across Windows, Linux, macOS, or any compatible VNC host. The server allows agents to view graphical user interfaces by capturing screenshots and interact directly with target environments using mouse movements, clicks, and keystrokes. Users can instruct an AI model to navigate remote desktop applications, fill out forms, trigger administrative shortcuts, or automate repetitive tasks that lack standard programmatic APIs. Communication is handled over standard stdio using Node.js, requiring standard VNC credentials such as host address, port, and password. By exposing low-level input control alongside screen capture capabilities, Mcp Vnc facilitates end-to-end graphical desktop interaction within language model tool-calling workflows.

Category: Cloud & Infrastructure

Tags: gui, remote-access, remote-desktop, vnc

Visit Mcp Vnc

How to install and configure Mcp Vnc

1. Install the package globally via npm by running npm install -g @hrrrsn/mcp-vnc, or clone the repository and run npm install followed by npm run build. 2. Open your Claude Desktop configuration file (such as ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows). 3. Add vnc-controller to the mcpServers object: json { "mcpServers": { "vnc-controller": { "type": "stdio", "command": "mcp-vnc", "env": { "VNC_HOST": "192.168.1.100", "VNC_PORT": "5900", "VNC_PASSWORD": "your-vnc-password" } } } } 4. Replace the environment variables with your target VNC host, port, and password, then restart Claude Desktop.

What you can do with Mcp Vnc

• Capturing delayed or immediate remote screen frames via vnc_screenshot to inspect visual state in an active desktop session. - Navigating desktop graphical interfaces by sending precise cursor movements and mouse clicks with vnc_move_mouse and vnc_click. - Entering login forms, shell commands, or multi-line configuration blocks using vnc_type_text and vnc_type_multiline tools. - Triggering operating system control shortcuts and system functions on remote hosts using vnc_key_press with modifier combinations.

Key facts

• https://github.com/hrrrsn/mcp-vnc
• Cloud & Infrastructure, Developer Tools & Code Intelligence
• gui, remote-access, remote-desktop, vnc

Part of MCP Servers

How do I install Mcp Vnc?

You can install Mcp Vnc globally via npm by running the command npm install -g @hrrrsn/mcp-vnc. Alternatively, you can clone the repository from GitHub, run npm install, and build the source files with npm run build using Node.js version 22 or higher.

What can Mcp Vnc do?

Mcp Vnc provides tools for remote desktop control over the VNC protocol. It enables AI clients to capture screenshots, move the mouse cursor, perform single or double clicks, send keystrokes and modifier combinations like Ctrl+Alt+Delete, and type single or multi-line text directly into the target environment.

Which MCP clients work with Mcp Vnc?

Mcp Vnc works with any client that supports standard Model Context Protocol servers over stdio. Documented configurations include Claude Desktop across macOS, Windows, and Linux, as well as Visual Studio Code via the Copilot Chat MCP integration.

Is Mcp Vnc open source?

Yes, Mcp Vnc is an open-source project distributed under the MIT License. The code and configuration details are publicly hosted in the project repository on GitHub.