mcp-remote-macos-use

# MCP Server - Remote MacOs Use **The first open-source MCP server that enables AI to fully control remote macOS systems.** **A direct alternative to OpenAI Operator, optimized specifically for autonomous AI agents with complete desktop capabilities, requiring no additional software installation.** [](https://hub.docker.com/r/buryhuang/mcp-remote-macos-use) [](https://opensource.org/licenses/MIT) **Showcases** - Research Twitter and Post Twitter(https://www.youtube.com/watch?v=--QHz2jcvcs) <img width="400" alt="image" src="https://github.com/user-attachments/assets/bfe6e354-3d59-4d08-855b-2eecdaaeb46f" /> - Use CapCut to create short highlight video(https://www.youtube.com/watch?v=RKAqiNoU8ec) <img width="400" alt="image" src="https://github.com/user-attachments/assets/3b4d07c5-cd25-4dae-b9a1-a373bf7492aa" /> - AI Recruiter: Automated candidate information collection, qualifying applications and sending screening sessions using Mail App - AI Marketing Intern: LinkedIn engagement - automated following, liking, and commenting with relevant users - AI Marketing Intern: Twitter engagement - automated following, liking, and commenting with relevant users ## To-Do List (Prioritized) 1. **Performance Optimization** - Match speed of Ubuntu desktop alternatives 2. **Apple Scripts Generation** - Reduce execution time while maintaining flexibility 3. **VNC Cursor Visibility** - Improve debugging and demo experience *We welcome contributions!* ## Features * **No Extra API Costs**: Free screen processing with your existing Claude Pro plan * **Minimal Setup**: Just enable Screen Sharing on the target Mac – no additional software needed * **Universal Compatibility**: Works with all macOS versions, current and future ## Why We Built This ### Native macOS Experience Without Compromise The macOS native ecosystem remains unmatched in user experience today and will continue to be the gold standard for years to come. This is where human capabilities truly thrive, and now your AI can operate in this environment with the same fluency. ### Open Architecture By Design * **Universal LLM Compatibility**: Work with any MCP Client of your choice * **Model Flexibility**: Seamlessly integrate with OpenAI, Anthropic, or any other LLM provider * **Future-Proof Integration**: Designed to evolve with the MCP ecosystem ### Effortless Deployment * **Zero Setup on Target Machines**: No background applications or agents needed on macOS * **Screen Sharing is All You Need**: Control any Mac with Screen Sharing enabled * **Eliminate Backend Complexity**: Unlike other solutions that require running Python applications or background services ### Streamlined Bootstrap Process * **Leverage Claude Desktop's Polished UI**: No need for developer-style Python interfaces * **Intuitive User Experience**: Interact with your AI-controlled Mac through a familiar, user-friendly interface * **Instant Productivity**: Start working immediately without configuration hassles ## Architecture <img width="912" alt="remote_macos_use_system_architecture" src="https://github.com/user-attachments/assets/75ece060-90e2-4ad3-bb52-2c69427001dd" /> ## Installation - [Enable Screen Sharing on MacOs](https://support.apple.com/guide/remote-desktop/set-up-a-computer-running-vnc-software-apdbed09830/mac) **If you rent a mac from macstadium.com, you can skip this step** - [Connect to your remote MacOs](https://support.apple.com/guide/mac-help/share-the-screen-of-another-mac-mh14066/mac) - [Install Docker Desktop for local Mac](https://docs.docker.com/desktop/setup/install/mac-install/) - [Add this MCP server to Claude Desktop](https://modelcontextprotocol.io/quickstart/user) You can configure Claude Desktop to use the Docker image by adding the following to your Claude configuration: ```json { "mcpServers": { "remote-macos-use": { "command": "docker", "args": [ "run", "-i", "-e", "MACOS_USERNAME=your_macos_username", "-e", "MACOS_PASSWORD=your_macos_password", "-e", "MACOS_HOST=your_macos_hostname_or_ip", "--rm", "buryhuang/mcp-remote-macos-use:latest" ] } } } ``` ### WebRTC Support via LiveKit This server now includes WebRTC support through LiveKit integration, enabling: - Low-latency real-time screen sharing - Improved performance and responsiveness - Better network efficiency compared to traditional VNC - Automatic quality adaptation based on network conditions To use WebRTC features, you'll need to: 1. Set up a LiveKit server or use LiveKit Cloud 2. Configure the LiveKit environment variables as shown in the configuration example above ## Developer Instruction ### Clone the repo ```bash # Clone the repository git clone https://github.com/yourusername/mcp-remote-macos-use.git cd mcp-remote-macos-use ``