Linux Computer Use MCP
Portable extraction of the computer-use MCP runtime configured in a local Codex installation. This is the community Linux backend from agent-sh/computer-use-linux, not an OpenAI model or a hosted service.
The bundled Linux executable is byte-for-byte identical to the locally configured runtime. See PROVENANCE.json for hashes and upstream attribution. The pinned upstream source reference is not established as the exact source used to compile this binary.
Quick start
Requires Linux x86-64 with glibc and Python 3. Run from a logged-in graphical desktop session:
git clone https://github.com/ru-aish/computer-use-linux-mcp.git
cd computer-use-linux-mcp
python3 bin/launch.py describe
python3 bin/launch.py doctor
python3 bin/client_config.py
Paste the generated JSON into a stdio MCP client's configuration. It contains absolute paths for your checkout. For Codex, add this to ~/.codex/config.toml, replacing the path:
[mcp_servers.computer-use-linux]
command = "python3"
args = ["/absolute/path/computer-use-linux-mcp/bin/launch.py", "mcp"]
Restart or reload the client after changing its configuration. The launcher defaults to MCP mode; it also forwards runtime commands such as doctor, apps, windows, state, and screenshot. Set COMPUTER_USE_RUNTIME to use a different compatible executable.
Desktop access
The launcher inherits the caller's session environment. Display access, AT-SPI accessibility, desktop portals and input permissions must be configured on the target computer. Use doctor to inspect prerequisites. Successful MCP startup does not prove that screenshot capture or input works on a new machine.
For KDE, examples/gnome-screenshot is the Spectacle compatibility helper extracted from the original setup. To opt in, prepend this repository's examples directory to PATH and set CODEX_COMPUTER_USE_SCREENSHOT_BACKEND=gnome-screenshot. It requires spectacle and access to your KDE session bus. Input configuration remains host-specific; no privileged input daemon is installed by this repository.
The original local launcher hard-coded a username, display, session bus and ydotool socket. Those machine-specific settings are deliberately replaced by inherited environment variables. The original Codex entry was disabled at extraction time. This repository does not change that installation.
Scope and access
This is a local stdio MCP server, not a public HTTP endpoint. A client running it can inspect and control the desktop with your account's permissions. Configure approval controls in your MCP client. No passwords, Cloudflare credentials, Codex authentication, browser profiles or personal session configuration are included.
The noVNC remote desktop is a separate service. This package does not automatically connect to or publish that display. Run it in the intended desktop environment if you want to control a virtual display.
Verify
python3 scripts/check_mcp.py
This checks binary hashes, initialization, tool discovery and ping without invoking desktop actions. Desktop operation must be verified separately on the target host.
License and provenance
The bundled backend is distributed with its upstream MIT license. Local packaging and the KDE compatibility helper are provided under the same MIT terms. Upstream attribution and pinned binary hashes are preserved in PROVENANCE.json. This snapshot is Linux x86-64/glibc only; it does not run on Android, macOS or Windows.