cua-mcp-server is a MCP server for the Computer-Use Agent (CUA), allowing you to run CUA through Claude Desktop or other MCP clients.
Get started with Agent
Prerequisites
Before installing the MCP server, you'll need to set up full Computer-Use Agent capabilities. This includes:
- Installing the Lume CLI
- Pulling the latest macOS CUA image
- Starting the Lume daemon service
- Installing the required Python libraries (Optional: only needed if you want to verify the agent is working before installing MCP server)
Make sure these steps are completed and working before proceeding with the MCP server installation.
Easy Setup Script
If you want to simplify installation, you can use this one-liner to download and run the installation script:
curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/python/mcp-server/scripts/install_mcp_server.sh | bash
You can then use the script in your MCP configuration like this:
{
"mcpServers": {
"cua-agent": {
"command": "/bin/bash",
"args": ["~/.cua/start_mcp_server.sh"],
"env": {
"CUA_MODEL_NAME": "anthropic/claude-3-5-sonnet-20241022"
}
}
}
}
Development Guide
If you want to develop with the cua-mcp-server directly without installation, you can use this configuration:
{
"mcpServers": {
"cua-agent": {
"command": "/bin/bash",
"args": ["~/cua/libs/python/mcp-server/scripts/start_mcp_server.sh"],
"env": {
"CUA_MODEL_NAME": "huggingface-local/ByteDance-Seed/UI-TARS-1.5-7B"
}
}
}
}
This configuration:
- Uses the start_mcp_server.sh script which automatically sets up the Python path and runs the server module
- Works with Claude Desktop, Cursor, or any other MCP client
- Automatically uses your development code without requiring installation
Just add this to your MCP client's configuration and it will use your local development version of the server.