desk
Provides automation for a virtual Linux desktop, including mouse and keyboard control, window management, launching programs, running shell commands, clipboard access, screenshots, and screen recording.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
auto-linux-desk
A virtual Linux desktop in Docker that you drive over HTTP or MCP. One container runs Xvfb, the Openbox window manager, a noVNC viewer and an API that moves the real mouse with human motion, types with human rhythm, presses window manager shortcuts, arranges windows, starts programs, runs shell commands, reads and writes the clipboard, takes screenshots and records the screen.
Use it as it is for Linux desktop automation, or build your own image on it: a plugin adds actions for the software you install, such as a browser.
Quick start
docker run -d --name desk \
-p 127.0.0.1:8080:8080 \
-p 127.0.0.1:5900:5900 \
psyb0t/auto-linux-deskOpen http://localhost:5900/ to watch the screen. Port 8080 serves the HTTP API and the MCP endpoint at /mcp/.
# Open a terminal with the window manager shortcut
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{"action":"send_key","key":"ctrl+alt+t"}'
# Type into it with human keystrokes
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{"action":"system_type","text":"uname -a\n"}'
# Or run a command directly
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{"action":"run_command","command":"ls -la /userdata"}'
# Look at the screen
curl "http://localhost:8080/screenshot/desktop?whLargest=512" -o desk.pngrun_command runs any command it is given and launch_app starts any program. With no AUTH_TOKEN, anyone who can reach port 8080 can run commands in the container. Set AUTH_TOKEN before exposing the port beyond loopback, or set DESK_EXEC_ENABLED=false to turn both off. See installation and security.
Related MCP server: linux-computer-mcp
What it can do
Area | Actions |
Mouse |
|
Keyboard |
|
Keyboard shortcuts |
|
Windows |
|
Programs and shell |
|
Screen |
|
Clipboard |
|
Events and handoff |
|
Scripts and utility |
|
Input coordinates are screen pixels. Input is sent through XTest, so every X client sees ordinary input events, with mouse paths, click timing and typing rhythm shaped like a person's.
MCP
claude mcp add --transport http desk http://localhost:8080/mcp/Most actions have their own MCP tool, and desk_action runs any action by name. The server instructions tell agents to use window manager shortcuts from desktop_keybindings, to enter text with paste_text, and to keep system_type for a few characters.
Script mode
docker run --rm -i psyb0t/auto-linux-desk --script < script.yamlThe container runs the YAML steps, prints one JSON document on stdout and exits with 0 when every step succeeded, 1 otherwise.
Building on it
Derived images install their software and set AUTO_LINUX_DESK_PLUGINS to Python modules whose register(registry) adds or replaces actions, MCP tools, routes, screenshots, state, health checks and lifecycle hooks. See plugins and derived images.
Documentation
The full documentation is at psyb0t.github.io/docker-auto-linux-desk.
Page | Covers |
Ports, environment variables, auth, users, volumes, hooks | |
Every endpoint, action and parameter | |
The window manager bindings | |
Client setup and tools | |
YAML format and output | |
The extension interface | |
Make targets and tests |
Development
make lint
make test-unit
make testEverything runs in containers. make help lists all targets.
Sponsor
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.
Cloud desktops for AI agents: create a Linux computer, see its screen, click, type and run tasks.
Linux VMs for AI agents: create VMs, run commands, edit files and open preview URLs.
Use a person's computer after they approve it there: files, Terminal, browser, local MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables full Linux desktop control including windows, mouse, keyboard, clipboard, audio, screenshots, OCR, accessibility, and system management through MCP-compatible AI agents.1MIT
- AlicenseNot gradedqualityDmaintenanceProvides an AI agent with a fixed, isolated Linux desktop workspace, enabling bounded screen capture, input control, and application launching via MCP.-
- AlicenseAqualityBmaintenanceEnables MCP agents to automate real GUI applications on headless desktops, providing background mouse/keyboard control, window/process management, screenshots, and safe human handoff without disturbing the user's desktop.594MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to control a Linux/X11 desktop like a human: see the screen, move the mouse, click UI elements via the accessibility tree, type text, and manage windows.MIT