MCP 服务器

mcp-remote-macos-use

第一个开源的MCP服务器，使AI能够完全控制远程macOS系统。

README

MCP服务器 - 远程MacOs使用

首个开源MCP服务器，使AI能够完全控制远程macOS系统。

OpenAI Operator的直接替代方案，专门为具有完整桌面功能的自主AI代理优化，无需安装额外的软件。

展示

研究Twitter并发布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" />
使用CapCut创建精彩短视频 (https://www.youtube.com/watch?v=RKAqiNoU8ec) <img width="400" alt="image" src="https://github.com/user-attachments/assets/3b4d07c5-cd25-4dae-b9a1-a373bf7492aa" />

特性

无额外API成本：使用您现有的Claude Pro计划进行免费屏幕处理
极简设置：只需在目标Mac上启用屏幕共享 - 无需其他软件
通用兼容性：适用于所有macOS版本，当前和未来

我们为何构建它

无需妥协的原生macOS体验

macOS原生生态系统在用户体验方面仍然是无与伦比的，并将继续成为未来几年的黄金标准。这是人类能力真正蓬勃发展的地方，现在您的AI可以在此环境中以相同的流畅度运行。

开放式架构设计

通用LLM兼容性：与您选择的任何MCP客户端一起使用
模型灵活性：与OpenAI，Anthropic或任何其他LLM提供商无缝集成
面向未来的集成：旨在与MCP生态系统一起发展

轻松部署

目标机器上零设置：macOS上不需要后台应用程序或代理
屏幕共享就是您所需要的：通过启用屏幕共享来控制任何Mac
消除后端复杂性：与其他需要运行Python应用程序或后台服务的解决方案不同

简化的引导过程

利用Claude Desktop的精美UI：无需开发人员风格的Python界面
直观的用户体验：通过熟悉的用户友好界面与AI控制的Mac进行交互
即时生产力：立即开始工作，无需配置麻烦

架构

安装

在MacOs上启用屏幕共享 如果您从macstadium.com租用mac，则可以跳过此步骤
连接到您的远程MacOs
为本地Mac安装Docker Desktop
将此MCP服务器添加到Claude Desktop 您可以通过将以下内容添加到Claude配置中来配置Claude Desktop以使用Docker镜像：

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

开发者说明

克隆仓库

# 克隆仓库
git clone https://github.com/yourusername/mcp-remote-macos-use.git
cd mcp-remote-macos-use

构建Docker镜像

# 构建Docker镜像
docker build -t mcp-remote-macos-use .

跨平台发布

要为多个平台发布Docker镜像，可以使用docker buildx命令。请按照以下步骤操作：

创建一个新的构建器实例（如果尚未创建）：
```
docker buildx create --use
```

构建并推送适用于多个平台的镜像：

docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-remote-macos-use:latest --push .

验证镜像是否可用于指定的平台：

docker buildx imagetools inspect buryhuang/mcp-remote-macos-use:latest

用法

该服务器通过MCP工具提供远程MacOs功能。

工具规范

该服务器提供四个主要的远程MacOS控制工具：

remote_macos_get_screen

获取远程桌面的屏幕截图。例子：

{
  "host": "remote-macos-hostname-or-ip",
  "port": 5900,
  "password": "remote-macos-password",
  "username": "remote-macos-username",
  "encryption": "prefer_on"
}

remote_macos_send_keys

发送键盘输入。例子：

{
  "host": "remote-macos-hostname-or-ip",
  "password": "remote-macos-password",
  "text": "Hello world!",
  "special_key": "enter",
  "key_combination": "cmd+c"
}

remote_macos_send_mouse

发送鼠标输入。例子：

{
  "host": "remote-macos-hostname-or-ip",
  "password": "remote-macos-password",
  "x": 500,
  "y": 300,
  "button": 1,
  "action": "click"
}

remote_macos_scale_coordinates

缩放不同屏幕尺寸之间的坐标。例子：

{
  "host": "remote-macos-hostname-or-ip",
  "password": "remote-macos-password",
  "source_width": 1366,
  "source_height": 768,
  "x": 500,
  "y": 300
}

所有工具都支持Apple身份验证（协议30），并且至少需要主机和密码。

局限性

身份验证支持：
- 仅支持Apple身份验证（协议30）

安全提示

https://support.apple.com/guide/remote-desktop/encrypt-network-data-apdfe8e386b/mac https://cafbit.com/post/apple_remote_desktop_quirks/

我们仅支持协议30，该协议使用具有512位素数的Diffie-Hellman密钥协商协议。当与OS X 10.11或更早版本的客户端通信时，macOS 11至macOS 12使用此协议。

这是转换为markdown表格的信息：

运行远程桌面的macOS版本	macOS客户端版本	身份验证	控制和观察	复制项目或安装软件包	所有其他任务	协议版本
macOS 13	macOS 13	2048位RSA主机密钥	2048位RSA主机密钥	2048位RSA主机密钥进行身份验证，然后是128位AES	2048位RSA主机密钥	36
macOS 13	macOS 10.12	仅本地的安全远程密码（SRP）协议。如果绑定到LDAP或macOS服务器是10.11或更早版本，则为Diffie-Hellman（DH）	SRP或DH，128位AES	SRP或DH进行身份验证，然后是128位AES	2048位RSA主机密钥	35
macOS 11至macOS 12	macOS 10.12至macOS 13	仅本地的安全远程密码（SRP）协议，如果绑定到LDAP，则为Diffie-Hellman	SRP或DH 1024位，128位AES	2048位RSA主机密钥 macOS 13至macOS 10.13	2048位RSA主机密钥 macOS 10.13或更高版本	33
macOS 11至macOS 12	OS X 10.11或更早版本	DH 1024位	DH 1024位，128位AES	具有512位素数的Diffie-Hellman密钥协商协议	具有512位素数的Diffie-Hellman密钥协商协议	30