rustdesk-mcp
Provides tools for managing and controlling remote devices via RustDesk, including device listing, shell commands, file operations, power controls, and screen interaction.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rustdesk-mcptake a screenshot of the device named office-pc"
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.
RustDesk MCP Server
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 │
└──────────┘Related MCP server: ssh-mcp
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 |
| List all registered devices |
| Get device details (OS, version, status) |
| Check if device is currently online |
Remote Commands
Tool | Description |
| Execute shell command on remote device |
| Take screenshot (returns base64 image) |
File Operations
Tool | Description |
| List files on remote device |
| Upload local file to remote device |
| Download file from remote device |
| Delete file on remote device |
Power Operations
Tool | Description |
| Restart remote device |
| Shutdown remote device |
| Lock remote device screen |
Screen Control (via xdotool on target)
Tool | Description |
| Send keystrokes |
| Move mouse to coordinates |
| 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 server URL |
|
| API login username |
|
| API login password |
|
| Request timeout (seconds) |
Usage
python -m rustdesk_mcpOr 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.pyRoadmap
Native RustDesk protocol screen control (not via shell)
Session management
Multi-user device filtering
File search on remote devices
Docker deployment
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for managing multiple SSH servers via AI assistants, offering tools for remote command execution, file operations, and system monitoring.11MIT
- AlicenseAqualityCmaintenanceAn MCP server that gives AI agents SSH access to remote machines through your local OpenSSH client, enabling remote command execution, file transfer, persistent shell sessions, and port forwarding.175MIT
- Alicense-qualityAmaintenanceMCP server enabling AI assistants to securely operate remote servers via persistent SSH sessions, with tools for command execution, file transfer, directory listing, and system monitoring.2MIT
- Alicense-qualityCmaintenanceMCP server that enables AI to see and control a physical computer via a JetKVM device for screen viewing, mouse/keyboard input, media mounting, and power management.1MIT
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for AI dialogue using various LLM models via AceDataCloud
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zsunny6658/rustdesk-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server