Which integrations are available for this server?

Enables remote desktop control of Linux systems via VNC, providing tools for mouse movement, clicking, keyboard input, and screen captures. Enables remote desktop control of macOS systems via VNC, providing tools for mouse movement, clicking, keyboard input, and screen captures.

How do I use mcp-vnc?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-vnc Take a screenshot of the desktop so I can see what's on the screen" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

💻 mcp-vnc

Node.js Version License: MIT npm version

A Model Context Protocol (MCP) server that enables AI agents to remotely control Windows, Linux, macOS or anything else that can run a VNC server (don't worry, it's probably fine).

Screenshot

🚀 Quick Start

Install from NPM

npm install -g @hrrrsn/mcp-vnc

Install from Source

git clone https://github.com/hrrrsn/mcp-vnc cd mcp-vnc npm install npm run build

⚙️ Configuration

Claude Desktop

Locate and open your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Add the following configuration:

Using NPM Install:

{ "mcpServers": { "vnc-controller": { "type": "stdio", "command": "mcp-vnc", "env": { "VNC_HOST": "192.168.1.100", "VNC_PORT": "5900", "VNC_PASSWORD": "your-vnc-password" } } } }

Built from Source:

{ "mcpServers": { "vnc-controller": { "type": "stdio", "command": "node", "args": ["dist/index.js"], "cwd": "/path/to/mcp-vnc", "env": { "VNC_HOST": "192.168.1.100", "VNC_PORT": "5900", "VNC_PASSWORD": "your-vnc-password" } } } }

VS Code

Please refer to the VS Code documentation

🛠️ Available Tools

The MCP server provides the following tools for remote desktop control:

🖱️ Mouse Control

Parameter	Required	Type	Description	Default
`x`	✅	number	X coordinate	-
`y`	✅	number	Y coordinate	-
`button`	❌	string	Mouse button (`left`, `right`, `middle`)	`left`
`double`	❌	boolean	Double-click instead of single click	`false`

Example: vnc_click(x=100, y=200, button="right", double=true)

Parameter	Required	Type	Description
`x`	✅	number	X coordinate
`y`	✅	number	Y coordinate

Example: vnc_move_mouse(x=500, y=300)

⌨️ Keyboard Control

Parameter	Required	Type	Description
`key`	✅	string	Key or key combination to press

Supported Keys:

Single keys: a, Enter, F1, Escape, Up, Down, Tab, Space
Key combinations: Ctrl+c, Alt+F4, Ctrl+Alt+Delete, Shift+Tab
Modifiers: Ctrl, Alt, Shift, Super/Win, Meta/Cmd

Examples:

vnc_key_press(key="Enter")
vnc_key_press(key="Ctrl+Alt+Delete")

📝 Text Input

Parameter	Required	Type	Description	Default
`text`	✅	string	Text to type	-
`enter`	❌	boolean	Press Enter after typing	`false`

Example: vnc_type_text(text="Hello World!", enter=true)

Parameter	Required	Type	Description
`lines`	✅	string[]	Array of lines to type

Example: vnc_type_multiline(lines=["Line 1", "Line 2", "Line 3"])

📸 Screen Capture

Parameter	Required	Type	Description	Default
`delay`	❌	number	Delay before screenshot (0-300000ms)	`0`

Example: vnc_screenshot(delay=1000) - Wait 1 second before capture

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

mcp-vnc