MCP Remote Macos Use

The first open-source MCP server that enables full-featured AI control of a remote macOS system without the need to install additional software, providing complete desktop operation capabilities.

Operating system automation Developer tools #Remote Control #AI Agent #macOS Automation #Open-Source Tool .Python

rating : 2.5 points

downloads : 8.2K

update time : 2025-04-28

Open Site

What is the MCP Remote MacOS Server?

The MCP Remote MacOS Server is an open-source tool that allows users to control remote MacOS devices via AI without the need to install additional software. It supports various functions such as screen sharing, keyboard input, and mouse operations, and is suitable for scenarios requiring efficient automated work.

How to use the MCP Remote MacOS Server?

Simply enable the screen sharing function on the target Mac and run the Docker image locally to start remote control.

Applicable Scenarios

Suitable for various tasks requiring cross-platform collaboration, such as marketing automation, data analysis, and customer service robots.

Main Features

Remote Screen Capture

Get a real-time screenshot of the remote MacOS desktop.

Keyboard Input

Send keyboard input instructions to the remote device.

Mouse Movement

Precisely control the position of the mouse cursor.

Drag-and-Drop Operation

Implement drag-and-drop operations for files or objects.

WebRTC Support

Achieve low-latency audio and video transmission through LiveKit.

Advantages

No additional API fees

Zero-configuration and rapid deployment

Strong cross-platform compatibility

Limitations

Only supports Apple-certified protocols

Performance optimization is still in progress

How to Use

Enable Screen Sharing

Ensure that screen sharing is enabled on the target MacOS.

Install Docker

Install Docker Desktop on your local computer.

Start the MCP Server

Run the Docker container to start the MCP server.

Usage Examples

Open CapCut to Edit Videos

Automatically open CapCut via AI and edit videos.

Send an Email

Send an email using the Mail application.

Frequently Asked Questions

Does it support other operating systems?

Do I need to pay additional fees?

Related Resources

Official Documentation

Project homepage and detailed instructions.

LiveKit Official Website

Understand the basics of WebRTC technology.

🚀 MCP Server

The MCP Server offers the capability to control remote macOS systems, including screen capture, keyboard input sending, mouse operations, and application management.

🚀 Quick Start

Environment Variable Configuration

The following environment variables are required for the MCP Server to run:

Property	Details
`MCP_SERVER_HOST`	The host address of the MCP Server, with a default value of `localhost`.
`MCP_SERVER_PORT`	The port on which the MCP Server listens, an integer type with a default value of `5000`.

Installation and Operation

Clone the repository:

git clone https://github.com/yourusername/mcp-server.git
cd mcp-server

Install dependencies:
```
pip install -r requirements.txt
```
Start the server:
```
python server.py
```

✨ Features

Tool Description

`remote_macos_get_screen`

Connect to a remote macOS machine and capture its screen.

`remote_macos_send_keys`

Send keyboard input to a remote macOS machine.

`remote_macos_mouse_move`

Move the mouse cursor to the specified coordinates, supporting automatic scaling.

`remote_macos_mouse_click`

Perform a single mouse click at the specified coordinates, supporting automatic scaling.

`remote_macos_mouse_double_click`

Perform a double mouse click at the specified coordinates, supporting automatic scaling.

`remote_macos_mouse_scroll`

Perform a mouse scroll operation at the specified coordinates, supporting automatic scaling.

`remote_macos_open_application`

Open or activate an application and return its PID for further interaction.

`remote_macos_mouse_drag_n_drop`

Perform a mouse drag-and-drop operation from the starting point to the ending point, supporting automatic scaling.

All tools use the environment variables configured during the setup process, rather than directly requiring connection parameters.

💻 Usage Examples

Basic Usage

import mcp

# Initialize the MCP client
client = mcp.Client(host='localhost', port=5000)

# Send keyboard input
client.send_keys('hello')

# Capture and save the screen
screenshot = client.get_screen()
screenshot.save('screen.png')

📚 Documentation

Installation and Configuration

Third - Party Dependencies

Libraries: mcp-core, mcp-rs
Version Requirements: >=1.0.0

Configuration Steps

Download and install the MCP Server.

Configure environment variables:

export MCP_SERVER_HOST=your-host
export MCP_SERVER_PORT=your-port

Start the service:
```
mcp-server start
```

Table Information

macOS Version for Remote Desktop	macOS Client Version	Authentication Method	Control and Observation	Copy Items or Installation Packages	Other Tasks	Protocol Version
macOS 13	macOS 13	2048 - bit RSA host key	2048 - bit RSA host key	Authenticate using a 2048 - bit RSA host key, then encrypt using 128 - bit AES	2048 - bit RSA host key	36
macOS 13	macOS 10.12	SRP protocol (local only) or DH protocol (bound to LDAP or macOS Server version 10.11 or earlier)	SRP or DH, encrypted using 128 - bit AES	Authenticate using SRP or DH, then encrypt using 128 - bit AES	2048 - bit RSA host key (macOS 13 or higher)	35
macOS 11 to macOS 12	macOS 10.12 to macOS 13	SRP protocol (local only) or DH protocol	Authenticate using SRP or DH, then encrypt using 128 - bit AES	Authenticate using a 2048 - bit RSA host key	-	34
macOS 11 to macOS 12	macOS 10.11	DH protocol	Authenticate using DH, then encrypt using 128 - bit AES	Authenticate using a 2048 - bit RSA host key	-	33

🔧 Technical Details

Authentication Support

Apple Authentication (Protocol 30): Only supports versions between macOS 11 and macOS 12.

Security Note

⚠️ Important Note

When accessing a remote macOS machine, ensure that you use a secure and authenticated connection. This tool is only for accessing trusted and authorized servers.