ContextQMD
Back to Qwen Code

cua-driver

packages/cua-driver/python/README.md

0.19.31.9 KB
Original Source

cua-driver

Python wrapper for cua-driver - a cross-platform MCP (Model Context Protocol) server for computer-use automation.

Installation

bash
pip install cua-driver

Usage

The package provides a cua-driver command that wraps the native Rust binary:

bash
# Start MCP server over stdio
cua-driver mcp

# Check version
cua-driver --version

# View help
cua-driver --help

Python API

You can also use the Python API directly:

python
from cua_driver import run_cua_driver, get_binary_path

# Run with custom args
exit_code = run_cua_driver(["mcp"])

# Get path to bundled binary
binary_path = get_binary_path()

Features

  • Cross-platform: Works on macOS (universal), Linux (x86_64), and Windows (x86_64/ARM64)
  • Zero dependencies: Pure Python wrapper with no external dependencies
  • Stdio passthrough: Transparent piping for MCP protocol communication
  • Bundled binary: No separate installation required - the Rust binary is included in the wheel

What is cua-driver?

cua-driver is a cross-platform MCP server that provides 40+ tools for:

  • Screen capture and window management
  • Mouse and keyboard automation
  • Accessibility tree interaction
  • Application launching and control

It enables AI agents to interact with desktop applications through the Model Context Protocol.

Platform Support

PlatformArchitectureStatus
macOSUniversal (ARM64 + x86_64)✅ Supported
Linuxx86_64✅ Supported
Windowsx86_64✅ Supported
WindowsARM64✅ Supported

License

MIT License - see LICENSE