RustDesk MCP Server
![License: MIT]()
MCP (Model Context Protocol) server that lets AI agents control remote machines via RustDesk.
Architecture
┌────────────┐ MCP stdio ┌──────────────┐ REST API ┌─────────────────┐
│ AI Agent │ ◄─────────────► │ rustdesk-mcp │ ────────────────► │ rustdesk-api │
│ (Claude/ │ │ Server │ │ (lejianwen) │
│ Cursor) │ └──────────────┘ └─────────────────┘
└────────────┘ │
▼
┌──────────┐
│ RustDesk │
│ Devices │
└──────────┘
Components and Where They Run
| Component |
Where |
Description |
| rustdesk-mcp (this project) |
NAS/server |
MCP server that translates AI requests to rustdesk-api calls |
| rustdesk-api-server |
NAS/server |
Third-party RustDesk API server (by lejianwen, Go) — device management, shell, file ops |
| RustDesk client |
Each target machine |
Normal RustDesk client, registers with api-server |
| MCP client |
Control machine |
Cursor/Claude/etc. — where the AI agent runs |
Features
Device Management
| Tool |
Description |
rd_device_list |
List all registered devices |
rd_device_info |
Get device details (OS, version, status) |
rd_device_online |
Check if device is currently online |
Remote Commands
| Tool |
Description |
rd_device_shell |
Execute shell command on remote device |
rd_device_screenshot |
Take screenshot (returns base64 image) |
File Operations
| Tool |
Description |
rd_device_file_list |
List files on remote device |
rd_device_file_upload |
Upload local file to remote device |
rd_device_file_download |
Download file from remote device |
rd_device_file_delete |
Delete file on remote device |
Power Operations
| Tool |
Description |
rd_device_restart |
Restart remote device |
rd_device_shutdown |
Shutdown remote device |
rd_device_lock |
Lock remote device screen |
Screen Control (via xdotool on target)
| Tool |
Description |
rd_device_keypress |
Send keystrokes |
rd_device_mouse_move |
Move mouse to coordinates |
rd_device_mouse_click |
Click mouse at coordinates |
Prerequisites
- RustDesk client installed on target devices
- rustdesk-api-server running (default:
http://127.0.0.1:21114)
Installation
cd /vol3/1000/app/rustdesk-mcp
pip install -r requirements.txt
# or: pip install -e .
Configuration
Edit .env with your rustdesk-api credentials:
| Variable |
Default |
Description |
RUSTDESK_API_BASE_URL |
http://127.0.0.1:21114 |
rustdesk-api server URL |
RUSTDESK_API_USERNAME |
default |
API login username |
RUSTDESK_API_PASSWORD |
default |
API login password |
RUSTDESK_TIMEOUT |
30 |
Request timeout (seconds) |
Usage
python -m rustdesk_mcp
Or add to MCP client config:
{
"mcpServers": {
"rustdesk": {
"command": "python",
"args": ["-m", "rustdesk_mcp"],
"env": {
"RUSTDESK_API_BASE_URL": "http://127.0.0.1:21114",
"RUSTDESK_API_USERNAME": "default",
"RUSTDESK_API_PASSWORD": "default"
}
}
}
}
Project Structure
rustdesk-mcp/
├── README.md
├── LICENSE
├── .gitignore
├── pyproject.toml
├── requirements.txt
└── rustdesk_mcp/
├── __init__.py
├── __main__.py
└── server.py
Roadmap
- Native RustDesk protocol screen control (not via shell)
- Session management
- Multi-user device filtering
- File search on remote devices
- Docker deployment
License
MIT
