MCP服务器 - 远程MacOS使用方案

首个支持AI完全控制远程macOS系统的开源MCP服务器

OpenAI Operator的直接替代方案，专为具备完整桌面能力的自主AI代理优化设计，无需安装任何额外软件

功能展示

研究Twitter并发布内容(https://www.youtube.com/watch?v=--QHz2jcvcs)
使用CapCut制作短视频集锦(https://www.youtube.com/watch?v=RKAqiNoU8ec)
AI招聘专员：自动收集候选人信息、筛选申请并通过邮件应用发送面试邀请
AI营销实习生：LinkedIn互动 - 自动关注、点赞并与相关用户评论互动
AI营销实习生：Twitter互动 - 自动关注、点赞并与相关用户评论互动

待办事项清单（优先级排序）

性能优化 - 达到Ubuntu桌面替代方案的响应速度
Apple脚本生成 - 在保持灵活性的同时减少执行时间
VNC光标可见性 - 改善调试和演示体验

我们欢迎贡献！

核心特性

零额外API成本：使用现有Claude Pro计划即可免费处理屏幕内容
极简设置：只需在目标Mac上启用屏幕共享 - 无需安装其他软件
全版本兼容：适用于所有macOS版本（当前及未来版本）

开发初衷

不妥协的原生macOS体验

macOS原生生态系统至今仍保持着无与伦比的用户体验，并将在未来多年保持黄金标准。这是人类能力真正发挥的环境，现在您的AI也能在这个环境中以同样的流畅度运行。

开放式架构设计

通用LLM兼容性：支持任何您选择的MCP客户端
模型灵活性：无缝集成OpenAI、Anthropic或任何其他LLM提供商
面向未来的集成：专为随MCP生态系统演进而设计

一键部署

目标机器零配置：macOS上不需要后台应用程序或代理
仅需屏幕共享：只需启用屏幕共享即可控制任何Mac
消除后端复杂性：不同于需要运行Python应用或后台服务的其他解决方案

简化的启动流程

利用Claude Desktop的精美界面：无需开发者风格的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=您的macos用户名",
        "-e",
        "MACOS_PASSWORD=您的macos密码",
        "-e",
        "MACOS_HOST=您的macos主机名或IP",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

通过LiveKit支持WebRTC

该服务器现在通过LiveKit集成支持WebRTC，提供：

低延迟实时屏幕共享
更高的性能和响应速度
相比传统VNC更好的网络效率
根据网络条件自动调整质量

要使用WebRTC功能，您需要：

设置LiveKit服务器或使用LiveKit Cloud
按照上述配置示例设置LiveKit环境变量

开发者指南

克隆仓库

# 克隆仓库
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

连接到远程macOS机器并获取远程桌面的截图。使用环境变量进行连接配置。

remote_macos_send_keys

向远程macOS机器发送键盘输入。使用环境变量进行连接配置。

remote_macos_mouse_move

将鼠标光标移动到远程macOS机器上的指定坐标，自动进行坐标缩放。使用环境变量进行连接配置。

remote_macos_mouse_click

在远程macOS机器上的指定坐标执行鼠标单击，自动进行坐标缩放。使用环境变量进行连接配置。

remote_macos_mouse_double_click

在远程macOS机器上的指定坐标执行鼠标双击，自动进行坐标缩放。使用环境变量进行连接配置。

remote_macos_mouse_scroll

在远程macOS机器上的指定坐标执行鼠标滚动，自动进行坐标缩放。使用环境变量进行连接配置。

remote_macos_open_application

打开/激活应用程序并返回其PID以供进一步交互。

remote_macos_mouse_drag_n_drop

在远程macOS机器上执行从起点到终点的鼠标拖放操作，自动进行坐标缩放。

所有工具都使用设置期间配置的环境变量，而不需要连接参数。

限制

认证支持：
- 仅支持Apple认证（协议30）

安全提示

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

我们仅支持使用Diffie-Hellman密钥协商协议（512位素数）的协议30。该协议用于macOS 11到macOS 12与OS X 10.11或更早客户端通信时。

以下是转换为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

访问远程macOS机器时始终使用安全、经过认证的连接。此工具应仅在与您信任并有权访问的服务器一起使用。

许可证

详情请参阅LICENSE文件。