Installation

Install the package from PyPI:

pip install cua-mcp-server

This will install:

• The MCP server
• CUA agent and computer dependencies
• An executable cua-mcp-server script in your PATH

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

This script will:

• Create the ~/.cua directory if it doesn't exist
• Generate a startup script at ~/.cua/start_mcp_server.sh
• Make the script executable
• The startup script automatically manages Python virtual environments and installs/updates the cua-mcp-server package

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"
      }
    }
  }
}

Troubleshooting

If you get a /bin/bash: ~/cua/libs/python/mcp-server/scripts/start_mcp_server.sh: No such file or directory error, try changing the path to the script to be absolute instead of relative.

To see the logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log